v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Card Lifecycle

Activate Card

Activate a physical card.

post/v1/issuing/cards/activate

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-keystring uuid

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Request body

card_idstring uuid required

Unique identifier for card.

activation_codestring required

Activation code for the card.

pinstring required

New PIN for the card, must be a 6-digit numeric value.

no_pin_payment_amountnumber

The allowable amount for card transactions without PIN verification. Default NO-PIN transaction amount applied when not explicitly set by the customer. Defaults to 200 SGD.

If you would like to opt-out from having any transactions without credentials or password, you may adjust the amount to zero (0).

Note: This setting is only applicable to Business Visa. See Card products and No-PIN payments for more information.

Example request

{
  "card_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
  "activation_code": "12345678",
  "pin": "123456",
  "no_pin_payment_amount": 100
}

Response

Activate card successfully.

request_status'SUCCESS' required

Request status.