Send a payment link

A payment link is a URL that collects money. No client, no callback handling — send it to somebody and they pay.

Create one

curl -X POST https://sandbox.inversepay.app/api/b/v1/payment-links \
  -H "Authorization: Bearer $INVERSEPAY_TEST_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Invoice 1042",
    "currency": "RWF",
    "amount_minor": 2500000,
    "usage": "single_use"
  }'

amount_minor is 25,000 RWF. Only title and currency are required — leave the amount out and set "amount_type": "open" to let the payer choose, with min_amount_minor and max_amount_minor to bound it.

What you get back

The response carries the link's URL and its id. Send the URL; keep the id.

Then what

A paid link produces a charge, the same object a direct charge produces — so whatever you already do with charges works here without a second code path. Watch for it with the charge.succeeded webhook, or poll GET /charges.

Disable a link without deleting it:

curl -X POST https://sandbox.inversepay.app/api/b/v1/payment-links/$LINK_ID/disable \
  -H "Authorization: Bearer $INVERSEPAY_TEST_KEY"