SIMULATE card.creation_failed

POST

Sends a signed card.creation_failed delivery to {{webhook_url}}. data.reason explains the failure (e.g. card_declined, kyc_rejected, provider_unavailable). The card creation fee was already refunded to your tenant balance automatically — no action needed on billing; just mark the card failed on your side.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paylandcard.com/' \
--header 'User-Agent: Payland-Card-Webhook/1' \
--header 'X-Payland-Event: card.creation_failed' \
--header 'X-Payland-Delivery: whd_{{$guid}}' \
--header 'X-Payland-Signature: sha256={{webhook_signature}}' \
--header 'Content-Type: application/json' \
--data '{
    "id": "evt_01kx1z7r9wb3t8n6p4j2d5m0xq",
    "event": "card.creation_failed",
    "created_at": "2026-07-08T12:03:00+00:00",
    "data": {
        "id": "card_01kx0hqyr1v9ravmyhqdwzky7c",
        "user_id": "usr_01kx0hq7p3y52m0fbwn4gftzht",
        "brand": null,
        "masked_pan": null,
        "last4": null,
        "exp_month": null,
        "exp_year": null,
        "status": "failed",
        "balance": 0,
        "currency": "USD",
        "reason": "card_declined"
    }
}'

Response Example

{}

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

SIMULATE card.created