create_payment_link
Create a payment link in PKR for Pakistan via Safepay. Buyer pays with cards and local payment methods on the Safepay hosted checkout. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-safepay-public-key; free test credentials from getsafepay.com never move real money). Money always flows buyer→Safepay→merchant; this service never touches funds.
Parameters5
| amount_pkr | number | required | Amount in PKR (decimals allowed), e.g. 100. Minimum 10. |
| 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_pkr": {
"type": "number",
"minimum": 10,
"maximum": 100000000,
"description": "Amount in PKR (decimals allowed), e.g. 100. Minimum 10."
},
"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_pkr",
"description"
]
}