We use cookies to optimize your user experience. All information shared with us through cookies is secure and covered by our data privacy obligations. To learn more, view our privacy policy.
KongaPay Logo
KongaPayDevelopers
DevelopersPayment LinkCreate Payment Request

Create Payment Request

Creates a payment link and returns the generated payment URL.

POST{{eagle_base_url}}/request/payment-service/payment-request
Headers
{
  "Integration-secret-key": "{{merchant-secret-key}}"
}
FieldTypeRequiredDescription
titlestringYesPayment link title displayed to the customer.
amountnumber|nullNoAmount to collect. Use null for open-amount links when supported.
expires_atstring|nullNoExpiry timestamp in YYYY-MM-DD HH:mm:ss format.
descriptionstring|nullNoPayment description.
statusstringYesenabled, disabled, or completed.
success_messagestring|nullNoMessage shown after successful payment.
reusablebooleanNoAllows multiple successful payments on the same link.
callback_urlstring|nullNoMerchant callback URL.
bearerstring|nullNoFee bearer value.
Sample Request
{
  "title": "string",
  "amount": 0,
  "expires_at": "2026-09-28 00:00:00",
  "description": "string",
  "status": "enabled",
  "reusable": false,
  "callback_url": "https://merchant.example.com/payment/callback",
  "bearer": "customer"
}
ℹ️
Underlying payment-service route: POST /v2/payment_request.