v1

latestOpenAPI 3.0.12026-07-243407211.3 MB

ExternalAccount

Link a card to a customer profile.

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

post/programs/{programCode}/externalAccounts/customers/{customerToken}/cards

Path parameters

programCodestring required

Program code assigned to the partner.

customerTokenstring required

Unique customer token.

Headers

X-GD-RequestIdstring required

Unique request identifier (GUID).

X-GD-CustomerTypestring

Type of customer (default: External).

Request body

saltstring required

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

Example request

{
  "salt": "00000000-0000-0000-0000-000000000000"
}

Response

Card linked successfully.

Example response

{
  "link": {
    "linkId": "00000000-0000-0000-0000-000000000000"
  },
  "responseDetails": [
    {
      "code": 0,
      "subCode": 0,
      "description": "Success",
      "url": "http://tbd"
    }
  ]
}