Save card

Saves the client's card and returns its token pg_card_token.

The card is saved for pg_user_id: pass the token with the same pg_user_id in later requests instead of card details.

Sign the request with the secret key: see Sync API Overview.

If pg_3ds = 1 is returned, the client completes 3DS, then call Save card: complete 3DS: the token is returned there.

Result

Response	Meaning	Next step
`pg_status` = `ok`, `pg_3ds` = `0`	The card is saved.	Store `pg_card_token`.
`pg_status` = `ok`, `pg_3ds` = `1`	3DS is required.	Open `pg_3d_acsurl` for the client, then call Save card: complete 3DS.
`pg_status` = `error`	The request is rejected.	See the table «Errors».

Card saving flow

Errors

The HTTP status is always 200; the error is returned in pg_error_code and pg_error_description.

`pg_error_code`	When	What to do
`94031`	A field is not passed or has an invalid value, for example `pg_card_cvc`, or `pg_card_token` is not found.	Fix the request.
`1100`	The signature is missing or invalid.	Check the signature with the secret key.
`1101`	`pg_merchant_id` is not found. The response is not signed.	Check the merchant ID.
`10000`	The card cannot be saved.	Repeat the request later.
Other codes	The payment system declined the card.	See Error codes.

Request example

Saving by card details: required fields only. pg_sig is calculated with the secret key test_secret_key.
Line breaks in the body are added for readability: send the body as one line.

Responses

🟢200Success

application/xml

F - Frictionless Flow
C - Challenge Flow

Bodyapplication/xml

Examples

Card saved3DS required

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_payment_id>774</pg_payment_id>
    <pg_order_id>cs-r-docs_u_1792492731</pg_order_id>
    <pg_status>ok</pg_status>
    <pg_card_mask>4400-44XX-XXXX-4440</pg_card_mask>
    <pg_3ds>0</pg_3ds>
    <pg_secure_details>F</pg_secure_details>
    <pg_card_token>31804d34-8560-4e94-a873-fb5fe6be5dc1</pg_card_token>
    <pg_datetime>2026-10-20T10:38:52+00:00</pg_datetime>
    <pg_salt>QpzyRWvE0G3W7rlb</pg_salt>
    <pg_sig>82e97856d075791c50b52061843bd084</pg_sig>
</response>

🟢200Error

Result#

Card saving flow#

Errors#

Request example#

Request

Responses

Result

Card saving flow

Errors

Request example