1. Mobile balance
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
      • 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
    • Mobile balance
      • Overview
      • Create mobile balance payment
        POST
      • Charge mobile balance
        POST
      • Confirm payment with SMS code
        POST
      • Resend SMS code
        POST
      • Get mobile balance payment status
        POST
    • Invoice
      • 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
        • 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
        • Get application status
        • Application status notification
        • Change application 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. Mobile balance

Get mobile balance payment status

KZ
https://api.freedompay.kz
KZ
https://api.freedompay.kz
POST
https://api.freedompay.kz
/get_status3.php
The same method as Get payment status in the «Purchase» section: see it for the request fields, the response, errors and examples.
Returns the current state of a mobile balance payment found by pg_payment_id or pg_order_id.
Use it when Confirm payment with SMS code returned pg_status = process or the result did not come to pg_result_url.

Payment status request flow#

Result#

pg_statusMeaningNext step
okThe payment is found: pg_payment_status shows its state.success, error: the result is final. new, waiting, process: repeat the request later.
errorThe request itself failed.See «Errors» in Get payment status.

Request

Body Params multipart/form-data

Responses

🟢200Success
application/xml
Bodyapplication/xml

Example
<?xml version="1.0" encoding="UTF-8"?>
<root>
  <pg_status>ok</pg_status>
  <pg_payment_id>1022123803890</pg_payment_id>
  <pg_payment_status>new</pg_payment_status>
  <pg_testing_mode>1</pg_testing_mode>
  <pg_currency>KZT</pg_currency>
  <pg_amount>100</pg_amount>
  <pg_clearing_amount>100</pg_clearing_amount>
  <pg_refund_amount>-20.00</pg_refund_amount>
  <pg_revoked_amount>-50.00</pg_revoked_amount>
  <pg_captured>1</pg_captured>
  <pg_can_reject>1</pg_can_reject>
  <pg_payment_method>bankcard</pg_payment_method>
  <pg_payment_system>MBANKKGS</pg_payment_system>
  <pg_accepted_payment_systems>TESTPAYIN</pg_accepted_payment_systems>
  <pg_create_date>2026-10-22T17:48:34Z</pg_create_date>
  <pg_reference>261022174835</pg_reference>
  <pg_card_pan>6224-46XX-XXXX-XXX1278</pg_card_pan>
  <pg_card_name>IVAN IVANOV</pg_card_name>
  <pg_auth_code>367628</pg_auth_code>
  <pg_card_token>d7748317-cafa-4560-adfe-5c1075488b5e</pg_card_token>
  <pg_card_id>328</pg_card_id>
  <pg_user_phone>77777777777</pg_user_phone>
  <pg_user_email>client@example.com</pg_user_email>
  <pg_failure_code>99999</pg_failure_code>
  <pg_failure_description>Неизвестная ошибка платежной системы</pg_failure_description>
  <pg_refund_payments>
    <pg_refund_payment>
      <pg_refund_payment>
        <pg_payment_id>1022123803909</pg_payment_id>
        <pg_payment_status>success</pg_payment_status>
        <pg_amount>-20</pg_amount>
        <pg_payment_date>2026-10-22T18:07:45Z</pg_payment_date>
        <pg_reference>261022180741</pg_reference>
        <pg_failure_code>99999</pg_failure_code>
        <pg_failure_description>Неизвестная ошибка платежной системы</pg_failure_description>
      </pg_refund_payment>
    </pg_refund_payment>
  </pg_refund_payments>
  <pg_revoked_payments>
    <pg_revoked_payment>
      <pg_revoked_payment>
        <pg_payment_id>1022123803912</pg_payment_id>
        <pg_payment_status>success</pg_payment_status>
      </pg_revoked_payment>
    </pg_revoked_payment>
  </pg_revoked_payments>
  <pg_recurring_profile_id>61</pg_recurring_profile_id>
  <pg_recurring_profile_expiry_date>2027-10-22T00:00:00Z</pg_recurring_profile_expiry_date>
  <pg_salt>MkyZB6XwBnZjeHOkwEJyW4aJkixgzjIK</pg_salt>
  <pg_sig>49a036ad40fa3c30afb60802795fcfdb</pg_sig>
</root>
🟢200Error
Previous
Resend SMS code
Next
Overview