Sign in

v1

latestOpenAPI 3.0.12026-07-243407211.3 MB
PaymentInstrument

Activate Card via Account Identifier

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).
post/programs/{programCode}/accounts/{accountIdentifier}/activateCard

Path parameters

programCodestring required

The program code associated with the account.

accountIdentifierstring required

Unique identifier (UID or GUID) for the account.

Headers

X-GD-RequestIdstring required

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

Request body

last4Ssnstring nullable

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

paymentInstrumentIdentifierstring nullable

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

Response

OK

paymentInstrumentIdentifierstring nullable

The unique identifier of the payment instrument (e.g., card) that was activated.

activationStatusstring nullable

The activation status of the payment instrument.