POST/v1/payment-links

Create payment link

Creates a shareable hosted payment link (zero integration checkout).

Authentication

Secret Key — send Authorization: Bearer YOUR_KEY header.

Feature required

Requires payment_links enabled on your API app.

Request parameters

Parameter	Type	Required	Description
`amount`	string	Yes	Amount in "10.00" format
`currency`	string	Yes	USD or ZWG
`title`	string	Yes	Link title shown to customer
`description`	string	No	Optional description
`max_uses`	integer	No	Maximum number of payments
`expires_at`	string	No	ISO 8601 expiry

Response fields

Field	Type	Description
`id`	string	Payment link ID
`url`	string	Public payment URL
`slug`	string	Short slug for the link

Code examples

bash

curl -X POST https://api.watenga.africa/v1/payment-links \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "amount": "50.00",
        "currency": "USD",
        "title": "Invoice #42"
      }'

Response example

json

{
  "success": true,
  "data": {
    "id": "plink_01HQ",
    "url": "https://pay.watenga.africa/l/abc12xyz",
    "slug": "abc12xyz"
  }
}