Activate Card via Account Identifier

post

https://example.com/programs/{programCode}/accounts/{accountIdentifier}/activateCard

Activate a Card This endpoint gives the partner the ability to activate a card, if the customer (user) has the PAN, Expiration Date, and CVV. Once activated, the payment instrument identifier is returned. Also, the pan must be exactly 16 digits for the card to be activated. Things to Remember:

There are no limits on activateCard attempts.
If there is more than one “notActivated” Payment Instrument, when a newer Payment Instrument is “activated”, all older “notActivated” Payment Instruments will be set to “deactivated”.
Partners who accept Matricula Identification will be allowed to use the last four digits of the ID to activate a customer’s payment instrument(s) (cards). This allows the successful activation of their payment instrument and validation of their card verification value (CVV).

Path Params

programCode

string

required

The program code associated with the account.

accountIdentifier

string

required

Unique identifier (UID or GUID) for the account.

Body Params

The request object containing encrypted card activation data.

encryptedPrivatePaymentInstrumentData

object

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.

encryptedIdentifyingData

object

last4Ssn

string | null

The last four digits of the Social Security Number (SSN) for identity verification.

paymentInstrumentIdentifier

string | null

The unique identifier for the payment instrument (e.g., card) to be activated.

Headers

X-GD-RequestId

string

required

A unique identifier for tracking the request, provided in the X-GD-RequestId header.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

200OK

403Forbidden

500Internal Server Error

503Service Unavailable