Pay with Google Pay

Creates a payment with Google Pay and returns the result in the same response.

Pass the card data, the cryptogram and the ECI indicator from the decrypted Google Pay payment data. The CVC is not needed.

If 3DS authentication is required, the response contains pg_3d_acsurl: redirect the client to it; the payment is completed with Pay by card: complete 3DS.

Uniqueness can be enabled for the merchant: then a repeated request with the same pg_order_id is rejected with an error.

Test cards do not work for Apple Pay and Google Pay.

Result

`pg_status`	`pg_3ds`	Meaning	Next step
`ok`	`0`	The payment is authorized.	One-step payment: nothing else is needed. Two-step payment (`pg_auto_clearing` = 0): capture the amount with `clearing` or release it with `cancel`.
`ok`	`1`	3DS authentication is required.	Redirect the client to `pg_3d_acsurl` and complete the payment with Pay by card: complete 3DS: see «3DS authentication» in Pay by card.
`pending`	—	The payment system has not returned the result yet.	Request the status with `status_v2` until it is final.
`error`	—	The request is rejected or the payment is declined.	See «Errors» below.

Payment 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 parameter is missing or has an invalid value. `pg_error_description` names the parameter.	Fix the request.
`11005`	`pg_amount` is not a number, is less than 0.01 or more than 99999999.	Fix the amount.
`1380`	The amount is too small: the commission is greater than the amount. The payment is created with the `error` status, `pg_payment_id` is returned.	Increase the amount or contact Freedom Pay.
`1100`	The signature is missing or invalid.	Check the signature: see Sync API Overview.
`1101`	`pg_merchant_id` is not found. The response is not signed.	Check the merchant ID.
`99081`	A payment with this `pg_order_id` already exists: uniqueness of the order ID is enabled for the merchant.	Pass a new `pg_order_id`.
`10000`	The payment could not be performed.	Repeat the request later.
Other codes	The payment is declined by the issuer or the payment system. `pg_payment_id` is returned.	See Error codes.

Request example

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

Bodyapplication/xml

Examples

Success3DS authentication required

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_payment_id>1020101501500</pg_payment_id>
    <pg_status>ok</pg_status>
    <pg_3ds>0</pg_3ds>
    <pg_secure_details>F</pg_secure_details>
    <pg_auth_code>938930</pg_auth_code>
    <pg_reference>261020115739</pg_reference>
    <pg_datetime>2026-10-20T11:57:40+00:00</pg_datetime>
    <pg_salt>s9HM5akPDBrRPLoQ</pg_salt>
    <pg_sig>23e2d04cb2dad8980d4d473c2515f1e7</pg_sig>
</response>

🟢200Error

Result#

Payment flow#

Errors#

Request example#

Request

Responses

Result

Payment flow

Errors

Request example