API referenceEndpointsPayments
Confirm a partner-collected refund was paid by your system
POST
Only for partner-collected refund obligations. Call after your own idempotent refund succeeds. Repeating the same acknowledgement is safe. Never use this for Verity treasury refunds; Verity verifies those on-chain itself.
PartnerApiKeyheader
AuthorizationBearer <token>Authorization: Bearer <your_api_key>
Keep this credential on your server, never in browser or mobile app code.
A missing, invalid or disabled key returns 401 PLATFORM_KEY_INVALID.
Ask Verity to replace a lost or exposed key.
operationId*stringFormat
uuidRefund acknowledgement recorded.
application/json- response
success*booleandata*curl -X POST 'https://api-staging.theverity.xyz/api/v1/platform/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08/refund-confirmation' \ -H 'Authorization: Bearer <your_partner_api_key>'Example Response
{ "success": true, "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "request_key": "string", "raffle_id": 0, "purchase_id": 0, "status": "queued", "qty": 0, "total_usd": 0, "payment_deadline": "2019-08-24T14:15:22Z", "settlement_deadline": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "tickets": [ { "ticket_no": 0, "code": "string" } ], "retry_allowed": true, "error": "string", "refund_only": true, "refund_operation_id": "b5dfb603-0ee2-4d5b-8e76-a9d60c0e9d98", "source_payment_signature": "string" }}