Freedom Pay
  1. 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
          POST
        • Apple Pay
          POST
        • Google Pay
          POST
        • Samsung Pay
          POST
        • Token Payout
          POST
        • Status
          POST
    • 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)
      • Saved card with CVC input (Pay)
      • Non-acceptance payments
      • Non-acceptance payments (Pay)
      • Token payout
      • Status
    • Invoice
      • Introduction
      • Init
      • Info
      • Pay
      • Status
    • 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. 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.

Apple / Google / Samsung Pay#

A fast and secure way for one-touch online purchases. A customer of the store can pay with any card saved in his account. For merchant this payment will be processed like a regular payment by card.
If the purchase is made from a mobile device supporting Apple/Google/Samsung Pay, the customer will be asked to confirm the payment using a password, fingerprint or face recognition.
If the purchase is made from a device without the Apple/Google/Samsung Pay app, the customer can select any saved card in his account and confirm payment by passing 3D Secure authentication.
Additionally in the request to Freedom Pay Gateway it is necessary to pass parameters pg_eci_indicator and pg_online_payment_cryptogram

Interaction diagram for Token Pay and Apple / Google / Samsung Pay#

Status: success/error/pending
G2G_API_V3-Making a payment wiith Samsung Pay.drawio.png

Google Pay#

 Google Pay™ is a fast and secure way for one-touch online purchases. A customer of the store can pay with any card saved in his Google account. For merchant this payment will be processed like a regular payment by card.
 If the purchase is made from a mobile device supporting Google Pay, the customer will be asked to confirm the payment using a password, fingerprint or face recognition.
 If the purchase is made from a device without the Google Pay app, the customer can select any saved card in his Google account and confirm payment by passing 3D Secure authentication.
 All merchants must adhere to the Google Pay APIs Acceptable Use Policy and accept the terms defined in the Google Pay API Terms of Service

The principle of working with the service#

 By clicking on the Google Pay button, the user goes to the page where the payment methods saved in his Google account are indicated. This way he will be able to quickly choose the method of payment convenient for him.
Payment process:
By clicking the Google Pay button, the user goes to a page with a list of available payment methods and selects the desired one.
Google Pay securely transfers the token corresponding to the specified payment method to your site.
Your site sends its server a token and other payment details.
The server processes the data and transfers the token to the payment service provider.

Hosted Payments Page Integration#

 Instructions detailing how to integrate Google Pay™ into your Website using the Paybox Hosted Payments Page

Pre-requisites#

Read the Google Pay Web Brand Guidelines
Read the Google Pay APIs Acceptable Use Policy
Prior to implementing Google Pay, contact the manager to have Google Pay enabled on your account. You will be required to agree to the Google Pay Terms of Services. Paybox support representative will provide instructions on how to do this.

Implementation Steps#

 Follow the instructions of your manager. A Google Pay button will be displayed by default on the Hosted Payments Page once Google Pay has been enabled on your account

Web Integration#

 Instructions detailing how to integrate Google Pay™ into your Website using Paybox as your gateway

Pre-requisites#

Read the Google Pay Web Brand Guidelines
Follow Google Pay's [Deploy production environment guidelines](Follow Google Pay's Deploy production environment guidelines). In this step you will obtain a merchantID. By integrating Google Pay, you agree to Google's terms of service.
Contact your manager to have Google Pay enabled on your account. You will be supplied a gatewayMerchantID.

Implementation Steps#

 Follow the instructions in the following Google guides to implement a Google Pay button in your app:
Google Pay Web developer documentation
Google Pay Web integration checklist
 When setting up the tokenizationSpecification object, specify the following values for the gateway and gatewayMerchantId values:
gateway: payboxmoney
gatewayMerchantId: <Google MerchantID>
 The Google Pay button will generate an encrypted token that you must then include in a request to the Paybox API to:
Create a purchase using the card in the Google Pay payload
Or tokenize the card details in the Google Pay payload
 The following documentation outlines the format of the two API calls:
Create a purchase using a wallet
Tokenize a card with wallet credentials
 Supported authentication methods: PAN_ONLY and CRYPTOGRAM_3DS. Supported card networks are Visa and MasterCard.
 There is no need to transfer the billing address.The payment token received from Google must be passed in the token parameter in string format. It must be transferred in the same form in which you received it from Google. The rest of the options are described below.

Standard integration (only for web-sites)#

 Standard integration refers to hosting checkout page with Google Pay on merchant's website.
 To make a payment, you need to receive a payment token from Google Pay and transfer it to the payboxmoney payment gateway.
 Before you begin the integration, make sure that:
You have read with Google Pay API Overview;
Your web-page supports HTTPS protocol and has a domain-validated TLS certificate;
One of the following web browsers is being used: Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera, or UCWeb UC.
 Upon completion of the integration, you must ensure that:
You have completed all the required steps of Google Pay Web integration checklist
You followed Google Pay Web Brand Guidelines.

Samsung Pay#

 The ERR_UNKNOWN_URL_SCHEME error in WebView of Android app usually occurs when WebView encounters a URL, the scheme (for example, samsungpay://) of which is not
supported by default.
 Here are some steps that can help to solve this problem:

Handling URL schemes in WebView:#

 You need to intercept URLs with an unknown scheme and handle them manually. To do this,
use the shouldOverrideUrlLoading method in your WebViewClient.

Checking availability of Samsung Pay:#

 Make sure you have the Samsung Pay app installed on your device and configured correctly.

Internet permissions:#

 Make sure your app has permission to access the internet. In the AndroidManifest.xml file, add:
<uses-permission android:name="android.permission.INTERNET" />

Additional WebView settings:#

 Make sure that WebView is configured correctly to work with the required URLs.
 These steps should help you resolve the ERR_UNKNOWN_URL_SCHEME error when using Samsung Pay in the Android app's WebView. If the problem persists, additional diagnostics and adjustments to WebView or the application itself may be required. Or you can use our SDK, which already includes these fixes.

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.
When using this method, it is necessary to pass the pg_card_token in the request to the Freedom Pay Gateway.
To use this method, you should contact your manager.

Interaction diagram#

Status: success/error/pending
G2G_API_V3-Payout to card token.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.uz
Previous
Status
Next
Token Pay