Xtrempay Api Documentation

Add a new card

Pending

Cloud Mock

https://mock.apidog.com/m1/918700-0-default

POST

/v1/user/cards

Maintainer:Xtrempay Devs

Vault a new card via your gateway (send CVV once, store only token + masked details).

Request

Body Params application/json

Example

{
  "cardholderName": "Paul Ogechukwu",
  "cardNumber":     "7388748449591029",
  "expiryMonth":    12,
  "expiryYear":     2025,
  "cvv":            "000"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mock.apidog.com/m1/918700-0-default/v1/user/cards' \
--header 'Content-Type: application/json' \
--data-raw '{
  "cardholderName": "Paul Ogechukwu",
  "cardNumber":     "7388748449591029",
  "expiryMonth":    12,
  "expiryYear":     2025,
  "cvv":            "000"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "timestamp": "1750834347862",
    "status": 200,
    "success": true,
    "message": "Card Added Successfully.",
    "data": {
        "cardId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "cardholderName": "Paul Ogechukwu",
        "brand": "MASTERCARD",
        "last4": "1029",
        "maskedNumber": "7388 7484 **** 1029",
        "expiryMonth": 12,
        "expiryYear": 2025,
        "createdAt": "2025-06-25T14:22:31Z"
    }
}

🟠400Invalid input

Modified at 2025-06-30 23:35:14

Generate Account Statement

Delete Card