Freedom Pay
  1. Merchant API
  2. Token
Freedom Pay
  • Gateway API
    • Introduction
    • Reference
      • Test cards
      • Error codes
    • Sync API
      • Introduction
      • Page
        • Introduction
        • Page
        • Page with amount control
        • Status
      • Pay
        • Introduction
        • Card
        • 3DSecure
        • Cancel
        • Clearing
        • Refund
        • Status
      • Payout
        • Introduction
        • Card
        • IBAN
        • Balance
        • Status
        • StatusV2
      • Transfer
        • Introduction
        • Card
        • 3DSecure
        • Rates
        • Status
      • Card
        • Introduction
        • Add
        • 3DSecure
        • List
        • Remove
        • Status
      • Token
        • Introduction
        • Token Pay
        • Apple Pay
        • Google Pay
        • Samsung Pay
        • Token Payout
        • Status
    • Async API
      • Introduction
      • create
        • create payment
        • create payment recurrent
      • read
        • read payment
        • read request
      • edit
        • edit payment.refund
        • edit payment.reverse
        • edit payment.clearing
      • delete
  • Merchant API
    • Introduction
    • Reference
      • Test cards
      • Test phone numbers
      • Error codes
    • Page
      • Introduction
      • Page
      • Page with amount control
      • Payout page
      • Frame
      • Widget
      • Status
    • Pay
      • Introduction
      • Cancel
      • Clearing
      • Refund
      • Status
    • Payout
      • Introduction
      • IBAN
      • Balance
      • Status by order_id
      • Status by Payment ID
      • Status by Payment ID V2
    • Mobile balance
      • Introduction
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Card
      • Introduction
      • Add
      • Add for payout
      • Remove
      • List
      • Status
    • Token
      • Introduction
      • Saved card with CVC input (Init)
        POST
      • Saved card with CVC input (Pay)
        POST
      • Non-acceptance payments
        POST
      • Non-acceptance payments (Pay)
        POST
      • Token payout
        POST
      • Status
        POST
    • Invoice
      • Introduction
      • Init
      • Info
      • Pay
      • Status
    • ATM
      • Request for payment generation
      • Withdraw request
      • Request for the status of the operation
    • Additional
      • Introduction
      • Check request
      • Result notify
      • Payout notify
      • Redirect back
  • Card API
    • Introduction
    • Payment Cards
      • Reference
        • Request Status
        • Client product
        • Card product
        • Card status
        • Card block
        • Transaction
        • Error codes
      • Card issue
        • Bulk
        • Single
        • Physical
      • Card control
        • Activate
        • Block
        • Unblock
        • Set PIN
        • Reset PIN counter
        • Close
        • Identification
        • Info
        • Balance
        • Secret data
        • Statement
      • Client
        • Create
        • Edit
        • Card list
      • Additional
        • Request status
    • Gift Cards
      • Introduction
      • Reference
        • Request status
        • Card status
      • List
      • Issue
      • Confirm
      • Resend
      • Resend code
      • Status
  • Partner API
    • Rates
      • Introduction
      • Rates
    • Products
      • Introduction
      • Reference
        • Request
        • Product
        • Freedom POS
        • Freedom ECOM
        • Freedom BOX
        • Limits
      • Add user
      • Add product
      • Add user with product
      • Grant user
      • Send auth data
      • Request status
    • E-Money
      • Introduction
      • Reference
        • Request
        • Operation
        • Error codes
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Freedom ID
      • Introduction
      • Android SDK
      • iOS SDK
      • Reference
        • Error codes
      • Link
      • Token
      • Token refresh
      • Info
      • Profile
      • Request
  • Mobile SDK
    • Payment SDK
      • iOS
      • Android
    • Freedom QR
      • Reader SDK (Android)
      • Provider SDK (Android)
  • CMS
    • Introduction
    • Get Merchant ID and key
    • WordPress
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
      • Update
    • Tilda
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • InSales
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • Ecwid
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • Bitrix
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • PrestaShop
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • OpenCart
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
  1. Merchant API
  2. Token

Introduction

Token Pay#

 Card token payment is used to make a payment where a token is used instead of real card details (e.g., the card number).
 A token is a unique identifier generated for a specific card and used for transactions, ensuring data security.
 When using this method, it is necessary to pass the pg_card_token in the request to the Freedom Pay Gateway.
 This method may only be available if the card has been previously saved and tokenized.
To use this method, you should contact your manager.

Saved card with CVC input (Init)#

In this method, we initialize payment using a previously saved card.
At this stage, the existence of the pg_card_token sent by the merchant is verified. If everything is correct, Freedom Pay Gateway responds with a payment_id.

Saved card with CVC input (Pay)#

This method (Рay) is the actual payment using the token, with the input of the CVC, based on the previously created payment_id obtained in the previous step (Init).
The response from Freedom Pay Gateway will include an HTML form for entering the CVC details.

Interaction diagram#

Status: success/error/pending
Merchant_API_V3-Saved card with CVC input (Pay).drawio.png

Non-acceptance payments#

 Non-acceptance payments refer to a payment process where the recipient of the funds does not actively accept or approve the payment before it is processed. Instead, the funds are automatically credited to the recipient’s account without requiring any action from them.

Non-acceptance payments (Init)#

In this method, we initialize non-acceptance payment using a previously saved card.
At this stage, the existence of the pg_card_token sent by the merchant is verified. If everything is correct, Freedom Pay Gateway responds with a payment_id.

Non-acceptance payments (Pay)#

This method is the actual non-acceptance payment using the token, based on the previously created payment_id obtained in the previous step (Init).

Interaction diagram#

Status: success/error/pending
Merchant_API_V3-Non-acceptance payments.drawio.png

Token Payout#

Card token payout is used to make a payout where a token is used instead of real card details (e.g., the card number).
A token is a unique identifier generated for a specific card and used for transactions, ensuring data security.

Interaction diagram#

Status: success/error/pending
Merchant_API_V3-Token payout.drawio.png

Status#

This method is used to get information about the current status of a payment, such as whether it was successful, an error occurred, or is pending etc.

Support#

If you found an inaccuracy or need help, feel free to reach out! 👋
Email: support@freedompay.kg
Modified at 2025-02-03 10:48:15
Previous
Status
Next
Saved card with CVC input (Init)