Skip to main content

Documentation

Activate Issued Card Using Hosted Page

A contact can activate his or her physical issued card.

Rapyd sends you webhooks for the following actions:

Prerequisites

    • ewallet_contact

    • ID of the wallet contact that the card is assigned to. Must have a valid phone number. String starting with cont_.

    • 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

  • /v1/hosted/issuing/activate_card

  • Activate Card

  • 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"
    }'
  • {
        "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 -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
    }'
  • {
        "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 -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
    }'
  • {
        "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
        }
    }