Validate a Card

POST

/{tenantCode}/v1/gift-card/{cardId}/payment-channel/{paymentChannelId}

You can get details and validate a gift card by passing pin in the request body

Request

Path Params

Query Params

Header Params

Body Params application/json

Example

{
    "pin": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sandbox.api.confirmapay.com//v1/gift-card//payment-channel/?accountId' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pin": "string"
}'

Responses

🟢200 - Card detailsSuccess

application/json

Card details

Body

Example

{
    "data": {
        "id": "string",
        "balance": 0,
        "issuedAt": "2019-08-24T14:15:22.123Z",
        "expiresAt": "2019-08-24T14:15:22.123Z",
        "currencyCode": 36,
        "status": 100,
        "reloadable": true,
        "loadable": true,
        "pin": "string",
        "pinRequired": true
    },
    "description": {
        "code": "string",
        "message": "string"
    },
    "narrative": {
        "code": "string",
        "message": "string"
    }
}

🟠404 - Gift card not foundSuccess

Modified at 2026-02-12 10:28:34

Get a Card

Cancel a card