Skip to main content
POST
/
cards
/
{cardIdentifier}
/
replace
Replace a card
curl --request POST \
  --url https://apigwuat.corpay.com/cards/{cardIdentifier}/replace \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardTypeId": 1,
  "purchaseCategoryId": 2,
  "additionalEmbossing": "FLEET-01",
  "driverName": "James Smith",
  "vehicleRegNumber": "AB12 CDE",
  "cardGroupId": 12
}
'
{
  "$ref": "#/components/schemas/Status/example"
}

Documentation Index

Fetch the complete documentation index at: https://api.corpay.com/llms.txt

Use this file to discover all available pages before exploring further.

Performance expectations:
p50: 1200 ms, p99: 2200 ms.
Measured on successful requests (2xx), server-side only.
How to interpret these metrics

Authorizations

​
Authorization
string
header
required

Use OAuth2 client credentials to obtain a bearer token.

UAT token endpoint: POST https://apigwuat.corpay.com/keycloak/realms/longship/protocol/openid-connect/token

Example:

curl --location 'https://apigwuat.corpay.com/keycloak/realms/longship/protocol/openid-connect/token' \
--header 'accept: application/json' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=.......' \
--data-urlencode 'client_secret=......'

Path Parameters

​
cardIdentifier
integer
required

Body

application/json
​
cardTypeId
integer
​
purchaseCategoryId
integer
​
additionalEmbossing
string
Maximum string length: 200
​
driverName
string
Maximum string length: 80
​
vehicleRegNumber
string
Maximum string length: 8
​
cardGroupId
integer

Response

Operation status

The response is of type object.