create_payment_link
Create a payment link in KZT for Kazakhstan via Freedom Pay. Buyer pays with cards, Apple Pay / Google Pay via Freedom Pay. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-freedompay-merchant-id; free test credentials from freedompay.kz never move real money). Money always flows buyer→Freedom Pay→merchant; this service never touches funds.
Parameters5
| amount_kzt | integer | required | Amount in KZT (integer), e.g. 1000. Minimum 100. |
| description | string | required | What this payment is for (shown to the buyer, ≤200 chars) |
| customer_email | string | optional | Optional buyer email. |
| reference_id | string | optional | Your unique order reference (≤40 chars). Auto-generated if omitted. |
| success_url | string | optional | Optional https URL to send the buyer to after payment. |
Raw schema
{
"type": "object",
"properties": {
"amount_kzt": {
"type": "integer",
"minimum": 100,
"maximum": 100000000,
"description": "Amount in KZT (integer), e.g. 1000. Minimum 100."
},
"description": {
"type": "string",
"description": "What this payment is for (shown to the buyer, ≤200 chars)"
},
"customer_email": {
"type": "string",
"description": "Optional buyer email."
},
"reference_id": {
"type": "string",
"description": "Your unique order reference (≤40 chars). Auto-generated if omitted."
},
"success_url": {
"type": "string",
"description": "Optional https URL to send the buyer to after payment."
}
},
"required": [
"amount_kzt",
"description"
]
}