1. Payments
Freedom Pay
  • Overview
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Card data encryption
      • Payments
        • Overview
        • Pay by card
          POST
        • Pay by card: complete 3DS
          POST
        • Pay with Apple Pay
          POST
        • Pay with Google Pay
          POST
        • Pay by recurring profile
          POST
        • Create payment page
          POST
        • Create payment page with any amount
          POST
        • Capture payment (clearing)
          POST
        • Cancel payment
          POST
        • Refund payment
          POST
        • Get payment status
          POST
      • Payouts
        • Overview
        • Pay out to card
        • Pay out to IBAN
        • Get payout balance
        • Get payout status
      • Transfers
        • Overview
        • Transfer from card to card
        • Transfer from card to card: complete 3DS
        • Get exchange rates
        • Get transfer status
      • Saved cards
        • Overview
        • Save card
        • Save card: complete 3DS
        • List saved cards
        • Remove saved card
        • Pay by card token
        • Pay out to card token
        • Get payment status
    • Async API
      • Overview
      • Create
        • Create payment
        • Save card without a charge
      • Read
        • Get payment status
        • Get request result
      • Edit
        • Capture payment (clearing)
        • Cancel payment (reverse)
        • Refund payment
  • Merchant API
    • Overview
    • Payments
      • Overview
      • Checkout
      • Pay by saved card
        • Overview
        • Create payment
        • Confirm payment with CVC
        • Confirm payment without the client
      • Create payment
      • Create payment with a payment page template
      • Create payment in a payment frame
      • Create payment with any amount
      • Create recurring payment
      • Capture payment (clearing)
      • Cancel payment
      • Refund payment
      • Get payment status
    • Payouts
      • Overview
      • Create payout page
      • Pay out to saved card
      • Pay out to IBAN
      • Get payout status
      • Get payout balance
    • Saved cards
      • Get saved cards
      • Save card
      • Save card for payouts
      • Delete saved card
      • Save card without a charge
    • Mobile balance
      • Overview
      • Create mobile balance payment
      • Charge mobile balance
      • Get mobile balance payment status
      • Confirm payment with SMS code
      • Resend SMS code
    • Invoices
      • Overview
      • Recurring payments
        • Overview
        • Create recurring profile
        • Get recurring profile
        • Charge by recurring profile
        • Cancel recurring profile
        • Recurring profile notification
      • Tips
        • Overview
        • Create
      • Create invoice
      • Get invoice status
      • Get invoice details
      • Cancel invoice
      • Refund invoice
    • SDK
      • JS SDK
      • Merchant SDK
        • Android
        • iOS
        • Migration guide
    • CMS
      • Overview
      • Get Merchant ID and key
      • WordPress
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
        • Update
      • Tilda
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • InSales
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • Ecwid
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • Bitrix
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • PrestaShop
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • OpenCart
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • CS-Cart
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
    • Installment
      • Overview
      • Status
        • Get application status
        • Application status notification
        • Change application status
      • Get partners
      • Create application
    • Callbacks
      • Overview
      • Result notify
      • Check request
      • Payout notify
      • Redirect back
  • Partner API
    • Overview
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
      • Client request status
      • Create terminal
      • Update terminal limits
      • Product request status
    • E-Money
      • Overview
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Device ID
      • Android SDK
      • iOS SDK
    • Implement SuperApp
      • Overview
      • Pay
      • Refund
      • Status
    • Account
      • Overview
      • Create payment
      • Payment status
      • Batch statuses
      • Statement
      • Statement status
      • Balance
      • Balance status
    • Invoices
      • Info
  1. Payments

Pay with Google Pay

KZ
https://api.freedompay.kz
KZ
https://api.freedompay.kz
POST
https://api.freedompay.kz
/g2g/payment
Creates a payment with Google Pay and returns the result in the same response.
Pass the card data, the cryptogram and the ECI 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.

Payment flow#

Result#

pg_statuspg_3dsMeaningNext step
ok0The 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.
ok13DS authentication is required.Redirect the client to pg_3d_acsurl and complete the payment with Pay by card: complete 3DS: see «Payment flow with 3DS» 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.

Errors#

The HTTP status is always 200; the error is returned in pg_error_code and pg_error_description.
pg_error_codeWhenWhat to do
94031A parameter is missing or has an invalid value. pg_error_description names the parameter.Fix the request.
11005pg_amount is not a number, is less than 0.01 or more than 99999999.Fix the amount.
1380The 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.
1100The signature is missing or invalid, or pg_merchant_id is not found. If the merchant is not found, the response is not signed.Check the merchant ID and the signature: see Sync API Overview.
99081A payment with this pg_order_id already exists: uniqueness of the order ID is enabled for the merchant.Pass a new pg_order_id.
10000The payment could not be performed.Repeat the request later.
Other codesThe 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.

Request

Body Params multipart/form-data

Responses

🟢200Success
application/xml
Bodyapplication/xml

Examples
<?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
Previous
Pay with Apple Pay
Next
Pay by recurring profile