Tarlanpayments
Eng
Eng
  • Acquiring
    • General information
      • Structure of payment processing
      • Kinds of operations
      • 3D-Secure
      • PCI DSS
    • Types of transactions
    • Structure of system responses
    • Error code
    • Transaction statuses
    • Signature Creation
    • Additional parameters
    • Interaction with the payment method
      • Initiating funds receipts
      • Initiating pay out
      • Card link
      • Initiating funds using Apple Pay
      • Initiating funds using Google Pay
      • Iframe
    • Payments without form of payment
      • One click
    • Smart Pay
      • Google pay
    • Supplementary methods
      • Removal of a linked user card
      • Verification of transaction status
      • Receiving a list of cards
      • Refund
      • Upper fee calculation
    • Webhook of the payment system
      • Payment Status
      • Payment ready to be made
    • Tilda Publishing
    • Edit summary
  • AGWS
    • Account Status Codes Guide
    • Error Codes
    • Reason for operation rejection
    • Transaction Lifetime
    • Transaction Status Guide
    • Creating a Signature
    • Check account status
    • Make a payment
    • Checking the refill status
    • Checking the remaining balance on the account
    • Confirmation of funds debit
    • Creating a payment link
    • Showcase Flow
    • Service Provider Flow
    • Payment System Callback
    • Payment Processing Scheme
  • Receiving a fiscal receipt
  • Calculation of the upper commission
Powered by GitBook
On this page
  1. Acquiring
  2. Interaction with the payment method

Card link

  1. Creation of an action for card linking with reference to project_client_id.

  2. Creation of payment amounting to KZT 10.

  3. Merchant redirects to the payment page.

  4. When the payment is proceeded, KZT 10 refunded.

Результат привязки карты мерчант можете узнать в методе получения списка привязанных карт пользователя, Webhook отправляется после списания средств. При последующих оплатах пользователю будут доступны ранее привязанные карты.

Creating a transaction to link a card

POST https://prapi.tarlanpayments.kz/transaction/api/v1/transaction/primal/card-link

Headers

Name
Type
Description

Authorization*

String

Bearer Auto-rotation hash (see Signature Creating)

Request Body

Name
Type
Description

project_id*

Integer

Project ID

merchant_id*

Integer

Merchant ID

project_client_id*

String

Client ID on the project side

success_redirect_url*

String

Project page to which the user will be redirected after successful payment

failure_redirect_url*

String

Project page to which the user will be redirected after unsuccessful payment. If the value parameter was not uploaded, the redirect will be performed to success_redirect_url

description*

String

Description of payment

additional_data

Object

More Options

callback_url

String

Project URL for sending callback with transaction status (see Sending callback)

{
    "status": true,
    "message": "Success",
    "result": "https://process.tarlanpayments.kz?hash=$2a$10$nhrUYWm9sDVYqCL4LKxn9ugrdC4Pszz5wGaUsDYYIqCGc8ZA4Vu0y&transaction_id=100474"
}
{
    "status": false,
    "status_code": 5000,
    "message": "transaction already exists",
    "result": {}
}

curl --location 'https://prapi.tarlanpayments.kz/transaction/api/v1/transaction/primal/card-link'  \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sign' \
--data-raw '{
    "callback_url": "https://test.site/callback_url",
    "description": "desc",
    "failure_redirect_url": "https://www.test.com",
    "merchant_id": 2222,
    "project_client_id": "999",
    "project_id": 111,
    "success_redirect_url": "https://www.test.com",
    "additional_data": {
        "test": "value",
        "qwerty": "123"
    }
}'

Last updated 5 months ago