Card Authorization with Network Token

Creating a Card Authorization with Network Token

Beam allows network tokens as a payment method for card authorizations by specifying "paymentMethodType": "CARD_NETWORK_TOKEN" and providing network token details in the cardNetworkToken object.

Please refer to API Reference for more details of each field in the request body.

Here is an example of a request to create a card authorization using network tokenization:


POST https://api.beamcheckout.com/api/v1/card-authorizations
Content-Type: application/json
Authorization: Basic {{yourMerchantId}} {{yourApiKey}}
 
{
  "currency": "THB",
  "amount": 10000,
  "referenceId": "order_190821",
  "returnUrl": "https://www.beamcheckout.com",
  "paymentMethod": {
    "paymentMethodType": "CARD_NETWORK_TOKEN",
    "cardNetworkToken": {
      "number": "4111111111111111",
      "cryptogram": "",
      "cardHolderName": "Kumamon",
      "expiryMonth": 12,
      "expiryYear": 26,
      "first8": "41111111",
      "last4": "1111",
      "initiatorType": "CUSTOMER"
    }
  },
}

Note

number here is the tokenized card number provided by the card network, not the actual PAN.