--- title: "Activate Issued Card Using Hosted Page" source_url: https://docs.rapyd.net/en/activate-issued-card-using-hosted-page.html lang: en --- # Activate Issued Card Using Hosted Page A contact can activate his or her physical issued card. Rapyd sends you webhooks for the following actions: - Personalize a card - See [Bulk-Issued Card Personalized Webhook](https://docs.rapyd.net/en/bulk-issued-card-personalized-webhook.md "Bulk-Issued Card Personalized Webhook"). - Activate a card - See [Issued Card Activated Webhook](https://docs.rapyd.net/en/issued-card-activated-webhook.md "Issued Card Activated Webhook"). Prerequisites - Rapyd Wallet. See [Rapyd Wallet](https://docs.rapyd.net/en/rapyd-wallet-368670.md "Rapyd Wallet"). - Wallet contact with a valid phone number. See [Wallet Contact](https://docs.rapyd.net/en/wallet-contact-365061.md "Wallet Contact"). ### Parameters ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - idempotency - A unique key that prevents the platform from creating the same object twice. See [Idempotency](https://docs.rapyd.net/en/idempotency.md "Idempotency"). - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Request Body Parameters - - cancel_url - URL where the customer is redirected after pressing **Back to Website** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - - complete_url - URL where the customer is redirected after pressing **Close** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - - ewallet_contact - ID of the wallet contact that the card is assigned to. Must have a valid phone number. String starting with **cont_**. - - language - Determines the default language of the hosted page. For a list of values, see [List Supported Languages](https://docs.rapyd.net/en/list-supported-languages.md "List Supported Languages"). - When this parameter is null, the language of the user's browser is used. - If the language of the user's browser cannot be determined, the default language is English. - - page_expiration - End of the time when the customer can use the hosted page, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). If `page_expiration` is not set, the hosted page expires 14 days after creation. **Range:** 1 minute to 30 days. - - personalize - When **true**, connects an issued card to a wallet contact. Relevant to a card that was issued in bulk and is not assigned to a specific person. - - skip_pin - When **true**, the customer cannot reset the PIN. false ### Response Parameters - - cancel_url - URL where the customer is redirected after pressing **Back to Website** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - - complete_url - URL where the customer is redirected after pressing **Close** to exit the hosted page. This URL overrides the `merchant_website` URL. Does not support localhost URLs. - - ewallet_contact - ID of the wallet contact that the card is assigned to. Must have a valid phone number. String starting with **cont_**. - - geo_country - Reserved. - - id - ID of the hosted page for activating a card, a string starting with **hp_issuing_act_**. - - language - Determines the default language of the hosted page. For a list of values, see [List Supported Languages](https://docs.rapyd.net/en/list-supported-languages.md "List Supported Languages"). - When this parameter is null, the language of the user's browser is used. - If the language of the user's browser cannot be determined, the default language is English. - - merchant_alias - Client's name. Rapyd - - merchant_color - Color of the call-to-action (CTA) button on the hosted page. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_customer_support - Contains details of the client’s customer support. To configure these fields, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - email - Email address. - - url - URL for the client's customer support service. - - phone_number - Phone number for contacting the client's customer support service. - - merchant_logo - URL for the image of the client's logo. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_privacy_policy - URL for the terms and conditions of the agreement between the client and the client’s customers. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_terms - URL for the terms and conditions of the client. To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - merchant_website - The URL where the customer is redirected after exiting the hosted page. Relevant when one or both of the following fields is unset: - `cancel_url` - `complete_url` To configure this field, use the Client Portal. See [Customizing Your Hosted Page](https://docs.rapyd.net/en/customizing-your-hosted-page.md "Customizing Your Hosted Page"). - - page_expiration - End of the time when the customer can use the hosted page, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). If `page_expiration` is not set, the hosted page expires 14 days after creation. **Range:** 1 minute to 30 days. - - personalize - When **true**, connects an issued card to a wallet contact. Relevant to a card that was issued in bulk and is not assigned to a specific person. Transparent to the customer. See [Personalize Bulk-Issued Card](https://docs.rapyd.net/en/personalize-bulk-issued-card.md "Personalize Bulk-Issued Card"). false - - redirect_url - URL of the hosted page that is shown to the customer. - - region - Reserved. - - skip_pin - When **true**, the customer cannot reset the PIN via a hosted page. false - - status - Status of the hosted page. One of the following: - **NEW** - The hosted page was created. - **DON** - Done. The card was added to the customer profile. - **EXP** - The hosted page expired. - /v1/hosted/issuing/activate_card - Activate Card - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/hosted/issuing/activate_card' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "ewallet_contact": "cont_cb60ec28c2f0bdfc621cfc21270c20ce" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "92809032-eeaf-44a2-b6c0-3b2a916642c0" }, "data": { "status": "NEW", "cancel_url": "https://example1234.net", "complete_url": "https://example1234.net", "language": "", "org_id": "153e08b8-4bf3-4cb9-bb03-79d405eaed2a", "merchant_color": "323fff", "merchant_logo": "", "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1760617996, "redirect_url": "https://sandboxhosted.rapyd.net/otp?token=hp_issuing_act_df2c9b6817f3c9f4e921aa7f35d32afa", "id": "hp_issuing_act_df2c9b6817f3c9f4e921aa7f35d32afa", "ewallet_contact": "cont_cb60ec28c2f0bdfc621cfc21270c20ce" } } ``` - Personalize - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/hosted/issuing/activate_card' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "ewallet_contact": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "personalize": true }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "0c4f445f-cc59-4ef6-94e9-2b0caf538d34" }, "data": { "status": "NEW", "cancel_url": "https://rapyd.net", "complete_url": "https://rapyd.net", "language": "", "merchant_color": "323fff", "merchant_logo": "", "merchant_website": "https://rapyd.net", "merchant_customer_support": {}, "merchant_alias": "Doc Team", "merchant_terms": "", "merchant_privacy_policy": "", "page_expiration": 1667122081, "redirect_url": "https://sandboxcheckout.rapyd.net/otp?token=hp_issuing_act_9bd3c890277c6bb0f30637acd3f625bc", "region": null, "geo_country": null, "id": "hp_issuing_act_9bd3c890277c6bb0f30637acd3f625bc", "ewallet_contact": "cont_ceee1e56ff00768ffc14147d7474fb05", "personalize": true } } ``` - Prevent PIN Reset - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/hosted/issuing/activate_card' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "ewallet_contact": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "skip_pin": true }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "0d98bd62-7db6-4327-8e68-90238d226032" }, "data": { "status": "NEW", "cancel_url": "https://example1234.net", "complete_url": "https://example1234.net", "language": "", "org_id": "153e08b8-4bf3-4cb9-bb03-79d405eaed2a", "merchant_color": "323fff", "merchant_logo": "", "merchant_website": "https://example1234.net", "merchant_customer_support": { "url": "https://example1234.net", "email": "support@example1234.net", "phone_number": "121255551213" }, "merchant_alias": "Doc Team", "merchant_terms": "https://example1234.net/terms_and_conditions", "merchant_privacy_policy": "https://example1234.net/privacy_policy", "page_expiration": 1760618314, "redirect_url": "https://sandboxhosted.rapyd.net/otp?token=hp_issuing_act_1117745337474da2c60158b0ea0f80c6", "id": "hp_issuing_act_1117745337474da2c60158b0ea0f80c6", "ewallet_contact": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "skip_pin": true } } ```