Load Funds

POST

/api/v1/cards/{{card_id}}/load

Amount is in minor units (25000 = 250.00 USD). It is deducted from your tenant balance and added to the card balance (+ a load fee, if configured).

Mock scenario: amount=99999 → 422 provider_declined (load_declined), fully refunded.

The card must be ACTIVE: a pending/failed card returns 409 card_not_active (wait for the card.created webhook before loading).

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠409

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://api.paylandcard.com/api/v1/cards/{{card_id}}/load' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp: {{timestamp}}' \
--header 'X-Signature: {{signature}}' \
--header 'Accept: application/json' \
--header 'Idempotency-Key: {{$guid}}' \
--header 'Content-Type: application/json' \
--data '{
    "amount": 25000
}'

Response Example

200 - 200 — Success

{
    "data": {
        "card": {
            "id": "card_01kx0hqyr1v9ravmyhqdwzky7c",
            "user_id": "usr_01kx0hq7p3y52m0fbwn4gftzht",
            "brand": "VISA",
            "masked_pan": "401927******9855",
            "last4": "9855",
            "exp_month": 7,
            "exp_year": 2029,
            "status": "active",
            "balance": 25000,
            "currency": "USD",
            "created_at": "2026-07-08T12:01:00+00:00"
        },
        "transaction": {
            "id": "txn_01kx0hqyt1g7wm5c2jfs5zfs59",
            "type": "load",
            "amount": 25000,
            "card_balance_after": 25000,
            "status": "completed",
            "created_at": "2026-07-08T12:02:00+00:00"
        }
    },
    "status": true
}

Modified at 2026-07-17 06:22:49

Get Card

Card Transactions