Create

This method is used to create a tips transfer operation from a Sender (customer) to a Recipient (employee, courier, etc.) using the Recipient's previously saved bank card (card_token). The response contains a link to the payment form, to which the merchant redirects the Sender.
Before calling this method, the Recipient's card must be saved via POST /cardstorage/add2 with pg_template=tips.
If card_token is unknown, it can be retrieved using POST /v1/merchant/{merchant_id}/cardstorage/list

Request

Body Params application/jsonRequired

Example

{
    "amount": 500,
    "currency": "KZT",
    "external_id": "TIP-001",
    "main_order": {
        "external_id": "ORDER-123",
        "amount": 5000
    },
    "recipient": {
        "user_id": "courier-042",
        "card_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "sender": {
        "user_id": "customer-777",
        "phone": "77001234567"
    },
    "back_url": "https://merchant.kz/back",
    "post_link": "https://merchant.kz/callback"
}

application/json

Bodyapplication/json

Examples

SuccessError

{
	"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
	"status": "new",
	"redirect_url": "https://customer.freedompay.kz/tips?token=eyJhbGciOi...",
	"created_at": "2026-09-22T10:15:00Z"
}

Request

Responses