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 (50 symbols)
additional_data	Object	More Options
callback_url	String	Project URL for sending callback with transaction status (see Sending callback)

200: OK Example of a successful response

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

500: Internal Server Error Example of an error response

{
    "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"
    }
}'