Create Authorizations | American Express Developers

curl -X POST https://api.qasb2s.americanexpress.com/commercial/v1/card_on_demand/authorizations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "cardId": " CAEQd4zBEYrPi56",
  "authorizationDetails": [
    {
      "authorizationAmount": "200.00",
      "authorizationCurrency": "USD",
      "merchantNumber": "8906067845",
      "merchantName": "ABCD",
      "merchantCity": "Phoenix",
      "merchantState": "AZ",
      "merchantCountry": "US",
      "digitalWallet": "Apple Pay"
    }
  ]
}'

{
  "cardId": "CADT8UJhrYUscMR",
  "accountId": "CRXe8JnRUNOZCDn",
  "cardDetails": {
    "cardReferenceId": " PO12345-AB7890"
  },
  "authorizationDetails": [
    {
      "authorizationAmount": "200.00",
      "authorizationDate": "2016-07-07",
      "authorizationTimestamp": "2023-10-09T17:48:46+00:00",
      "authorizationStatus": "APPROVED",
      "lastFive": "11111",
      "merchantNumber": "8906067845",
      "merchantName": "ABCD",
      "merchantCity": "Phoenix",
      "merchantState": "AZ",
      "merchantCountry": "US",
      "authorizationId": "85345",
      "authorizationCurrency": "USD"
    }
  ]
}

Simulates and retrieves Authorizations for Virtual Cards in the Sandbox environment for integration. This API is not available in the Staging or Production environments.

Authentication

AuthorizationBearer

OAuth 2.0 client credentials. Exchange your API key and secret for a bearer token, then send it as Authorization: Bearer <token>.

Request

This endpoint expects an object.

cardIdstringRequired<=19 characters

A unique ID that is created for the Card.

authorizationDetailslist of objectsRequired

Response headers

Content-TypestringOptional

application/json

Request-IdstringOptional

The unique ID for the API request.

Response

Successful operation

cardIdstring<=19 characters

A unique ID that is created for the Card.

accountIdstring<=36 characters

A unique ID that is created for the Account.

cardDetailsobject

The details of the Card being created.

authorizationDetailslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error