1. Pay by saved card
Freedom Pay
  • Overview
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Card data encryption
      • Payments
        • Overview
        • Pay by card
        • Pay by card: complete 3DS
        • Pay with Apple Pay
        • Pay with Google Pay
        • Pay by recurring profile
        • Create payment page
        • Create payment page with any amount
        • Capture payment (clearing)
        • Cancel payment
        • Refund payment
        • Get payment status
      • Payout
        • Overview
        • Pay out to card
        • Pay out to IBAN
        • Get payout balance
        • Get payout status
      • Transfer
        • 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
      • Read
        • Get payment status
        • Get request result
      • Edit
        • Capture payment (clearing)
        • Cancel payment (reverse)
        • Refund payment
  • Merchant API
    • Overview
    • Purchase
      • Overview
      • Checkout
      • Pay by saved card
        • Overview
        • Create payment
          POST
        • Confirm payment with CVC
          POST
        • Confirm payment without the client
          POST
      • Create payment
        POST
      • Create payment with a payment page template
        POST
      • Create payment in a payment frame
        POST
      • Create payment with any amount
        POST
      • Create recurring payment
        POST
      • Cancel payment
        POST
      • Capture payment (clearing)
        POST
      • Refund payment
        POST
      • Get payment status
        POST
    • Payout
      • Overview
      • Create payment
      • IBAN
      • Balance status
      • Create payment
      • Status
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Invoice
      • Overview
      • Recurring profile
        • Overview
        • Create
        • Cancel
        • Info
        • Notify
      • Tips
        • Overview
        • Create
      • Create
      • Execute
      • Info
      • Refund
      • Status
      • Cancel
    • SDK
      • JS SDK
      • Merchant SDK
        • Google Pay
        • Android
        • IOS
    • 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
    • Installment
      • Overview
      • Status
        • Application Status
        • Application Callback Status
        • Application Change Status
      • Get partners
      • Create application
    • Saved cards
      • Get saved cards
      • Save card
      • Save card for payouts
      • Delete saved card
      • Save card without a charge
    • Redirect back
      POST
    • Result notify
      POST
    • Payout notify
      POST
    • Check request
      POST
  • Partner API
    • 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. Pay by saved card

Confirm payment without the client

KZ
https://api.freedompay.kz
KZ
https://api.freedompay.kz
POST
https://api.freedompay.kz
/v1/merchant/{merchant_id}/card/direct
Charges a saved card for a payment created by Create payment, without the client: no CVC and no 3DS.
Available after Freedom Pay enables it for the merchant: contact your account manager. Otherwise the response is error 1810.
The response contains the payment state in the same format as Get payment status.
The payment result is also sent to pg_result_url.

Payment flow#

Result#

ResponseMeaningNext step
pg_status = ok, pg_transaction_status = okThe payment is successful.—
pg_status = errorThe payment is declined or the request is rejected.See «Errors» below.

Errors#

The HTTP status is always 200; the error is returned in pg_error_code and pg_error_description. Error responses are signed.
HTTPpg_error_codeWhenWhat to do
2001100The signature is missing or invalid.Check the signature: see Merchant API Overview.
2001810Confirming without the client is not enabled for the merchant.Use Confirm payment with CVC, or contact your account manager.
2009001The payment is not found, or it is already paid or declined.Check the payment with Get payment status.
2001804The saved card is not approved or belongs to another merchant.Ask the client to save the card again.
200Other codesThe payment system declined the payment.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

Path Params

Body Params multipart/form-data

Responses

🟢200Success
application/xml
Bodyapplication/xml

Example
<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>1023122203689</pg_payment_id>
    <pg_can_reject>1</pg_can_reject>
    <pg_testing_mode>1</pg_testing_mode>
    <pg_payment_method>bankcard</pg_payment_method>
    <pg_amount>150</pg_amount>
    <pg_currency>KZT</pg_currency>
    <pg_transaction_status>ok</pg_transaction_status>
    <pg_captured>1</pg_captured>
    <pg_card_pan>4111-11XX-XXXX-1111</pg_card_pan>
    <pg_card_id>318</pg_card_id>
    <pg_card_token>a783d897-4167-46ba-85dc-2dbd8246fc48</pg_card_token>
    <pg_auth_code>332351</pg_auth_code>
    <pg_create_date>2026-10-25 20:59:57</pg_create_date>
    <pg_salt>Lp03OeEpSuvY6lav</pg_salt>
    <pg_sig>b06f89471aff28a823eb6409a15df3be</pg_sig>
</response>
🟢200Error
Previous
Confirm payment with CVC
Next
Create payment