Freedom Pay
  1. Transfer
Freedom Pay
  • Overview
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Purchase
        • Overview
        • Create payment
        • Any amount
        • Card
        • 3DSecure
        • Recurrent
        • Cancel
        • Clearing
        • Refund
        • Status
      • Payout
        • Overview
        • Card
        • IBAN
        • Balance
        • Status
      • Transfer
        • Overview
        • Card
          POST
        • 3DSecure
          POST
        • Rates
          POST
        • Status
          POST
      • Card
        • Overview
        • Add
        • 3DSecure
        • List
        • Remove
        • Status
      • Token
        • Overview
        • Token Pay
        • Apple Pay
        • Google Pay
        • Token Payout
        • Status
    • Async API
      • Overview
      • create
        • create payment
      • read
        • read payment
        • read request
      • edit
        • edit payment.refund
        • edit payment.reverse
        • edit payment.clearing
  • Merchant API
    • Overview
    • Purchase
      • Overview
      • Checkout
      • Card token
        • Overview
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment (with CVC)
        • Confirm payment (with CVC)
        • Create payment
        • Confirm payment
      • Create payment
      • Any amount
      • Cancel payment
      • Clearing
      • Refund payment
      • Status
    • Payout
      • Overview
      • Card token
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment
      • Create payment
      • IBAN
      • Balance status
      • Status by order_id
      • Status by Payment ID
      • Status
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Invoice
      • Overview
      • Init
      • Info
      • Pay
      • Status
    • SDK
      • JS SDK
      • Google Pay
      • Freedom QR
        • Reader SDK (Android)
        • Provider SDK (Android)
      • Payment SDK
        • iOS
        • Android
      • Merchant SDK
        • Android
    • 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
    • Redirect back
      POST
    • Result notify
      POST
    • Payout notify
      POST
    • Check request
      POST
  • Card API
    • Overview
    • Payment Cards
      • Overview
      • Dictionaries
      • Bulk issue
      • Issue card
      • Issue plastic card
      • Activate card
      • Block card
      • Unblock card
      • Set PIN
      • Reset PIN counter
      • Close card
      • Update client
      • Card info
      • Balance
      • Secret data
      • Secret data (version 2)
      • Operations' list
      • Statement extended
      • Create client
      • Edit client
      • Сards' list
      • Request' status
      • Create transaction
      • Clearing transaction
      • Refund transaction
      • Transaction info
      • Cardholder validation
      • Set limits
      • Limits list
    • Gift Cards
      • Overview
      • List
      • Issue
      • Confirm
      • Resend
      • Resend code
      • Status
  • Partner API
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
      • Request status
      • Create terminal
    • E-Money
      • Overview
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Freedom ID
      • Overview
      • Design
      • iOS SDK
      • Android SDK
      • OAuth2
        • Authorization link
        • Token exchange
        • Token refresh
        • User info
        • Request profile
        • Get profile status
        • Create user
        • Update user
      • OIDC
        • Authorization endpoint
        • Token exchange
        • Userinfo
      • Error codes
      • Examples
        • Keycloak
    • Transfer
      • Overview
      • Get token
      • Refresh token
      • Get agents
      • Fees
      • Create person
      • Create business
      • Create transfer
      • Print application
      • Confirm
      • Search
      • Payout
      • Payout confirm
      • Cancel
      • Get person info
      • Get business info
      • Status
      • Info
    • Device ID
      • Android SDK
      • iOS SDK
    • Implement SuperApp
      • Overview
      • Pay
      • Refund
    • Account
      • Settlement
        • Overview
        • Create payment
        • Payment status
    • Invoice
  1. Transfer

3DSecure

POST
https://api.freedompay.kz/g2g/p2p/transfer_acs
3D Secure (3DS) is an authentication technology to protect against unauthorized use of cards. It allows for verifying the cardholder’s identity before the payment is processed
The authentication process works as follows: after entering the card details, the issuer’s website opens, prompting the cardholder to enter a password or secret code. The code is usually sent via SMS. If the code is entered correctly, the payment is authorized; if not, the transaction is declined
3D Secure is available only for cards issued by banks that support this technology. Payments without 3D Secure are considered less secure

Interaction diagram for 3ds transfer#

Status: success/error/pending
G2G_API_V3-Making a transfer (P2P)  with 3DS.drawio.png

Request

Body Params multipart/form-data

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.freedompay.kz/g2g/p2p/transfer_acs' \
--form 'pg_merchant_id="";type=false' \
--form 'pg_payment_id="";type=false' \
--form 'pg_salt="";type=false' \
--form 'pg_sig="";type=false'

Responses

🟢200Success
application/xml
Body

Example
<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_payment_id>7777777777</pg_payment_id>
    <pg_order_id>980484</pg_order_id>
    <pg_payment_amount>10</pg_payment_amount>
    <pg_status>ok</pg_status>
    <pg_currency_from>USD</pg_currency_from>
    <pg_payment_date>2024-11-28 16:42:24</pg_payment_date>
    <pg_payment_status>success</pg_payment_status>
    <pg_card_mask>5555-55XX-XXXX-5555</pg_card_mask>
    <pg_card_token>11zxzxzxzxz-7zxzxz-4zxzx-4444-djng364ce8</pg_card_token>
    <pg_payout_amount>10</pg_payout_amount>
    <pg_currency_to>USD</pg_currency_to>
    <pg_card_recipient_mask>4444-44XX-XXXX-4444</pg_card_recipient_mask>
    <pg_card_recipient_token>fafafafafa-eaea-413dg-ddsdf2-432juithnj</pg_card_recipient_token>
    <pg_datetime>2024-11-28T11:42:34+00:00</pg_datetime>
    <pg_salt>43JI35rmdgnR</pg_salt>
    <pg_sig>gfdhgfedknj24kientl543njdxz</pg_sig>
</response>
🟢200Error
🟢200Invalid Signature
Modified at 2025-03-03 08:58:00
Previous
Card
Next
Rates