Link a card to a customer profile.

post

https://example.com/programs/{programCode}/externalAccounts/customers/{customerToken}/cards

Link a card to a customer profile using encrypted data. The card will be associated with the customer for future transfers.

Path Params

programCode

string

required

Program code assigned to the partner.

customerToken

string

required

Unique customer token.

Body Params

Encrypted card link request payload.

salt

string

required

Unique identifier (UUID) used by the encryption endpoint. Should match the RequestId provided in the header. Used for idempotency and encryption.

encryptedData

object

required

Represents a container for encrypted data used in secure data transfer operations. Contains the encrypted payload and associated cryptographic metadata, including encryption version, ephemeral public key, and public key hash. Used to securely transmit sensitive information such as user data, ensuring confidentiality and integrity during transport.

Headers

X-GD-RequestId

string

required

Unique request identifier (GUID).

X-GD-CustomerType

string

Defaults to external

Type of customer (default: External).

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Invalid or missing parameters.

401

Unauthorized access.

Language

Credentials

Header

Loading…

Response

Choose an example:

application/json

text/json

201Card linked successfully.

403Forbidden

500Internal Server Error

503Service unavailable.