# payments

> Payment links, UPI QR, evidence (claimed vs verified), refunds, settlements.

Payment links, UPI QR, evidence (claimed vs verified), refunds, settlements.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/payment-links` | `payment_links_list`: Payment links | `catalogs:read` | - |
| POST | `/v1/payment-links` | `payment_links_create`: Create a payment link through the connected Razorpay account | `payments:write` | - |
| GET | `/v1/payment-links/{link_id}` | `payment_links_get`: Get a payment link (status) | `catalogs:read` | - |
| POST | `/v1/payment-links/{link_id}/cancel` | `payment_links_cancel`: Cancel a payment link | `payments:write` | - |
| POST | `/v1/payment-links/{link_id}/resend` | `payment_links_resend`: Resend a payment link in a conversation | `payments:write` | - |
| GET | `/v1/payments` | `payments_list`: Gateway payments (links and UPI QR) | `payments:read` | - |
| GET | `/v1/payments/{payment_id}` | `payments_get`: Get a gateway payment | `payments:read` | - |
| POST | `/v1/payments/{payment_id}/mark-paid` | `payments_mark_paid`: Manual mark paid (claimed evidence only) | `payments:write` | - |
| POST | `/v1/payments/{payment_id}/refund` | `payments_refund`: Refund through the tenant gateway | `payments:write` | - |
| GET | `/v1/payments/evidence` | `payment_evidence_list`: Evidence log (claimed / verified / rejected) | `payments:read` | - |
| POST | `/v1/payments/evidence` | `payment_evidence_record`: Record a CLAIMED payment (screenshot or manual mark) | `payments:write` | - |
| POST | `/v1/payments/evidence/{evidence_id}/verify` | `payment_evidence_verify`: Verify claimed evidence against a gateway payment, or reject it | `payments:write` | - |
| GET | `/v1/payments/settlements` | `payments_settlements`: Settlement summary per gateway day | `payments:read` | - |
| POST | `/v1/payments/upi-qr` | `payments_create_upi_qr`: Create a dynamic single-use UPI QR (amount, reference, expiry) | `payments:write` | - |
| GET | `/v1/payments/upi-qr/{qr_id}` | `payments_get_upi_qr`: UPI QR status | `payments:read` | - |
| POST | `/v1/payments/upi-qr/{qr_id}/cancel` | `payments_cancel_upi_qr`: Close a UPI QR | `payments:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
