Partners
API referenceEndpointsPayments

Read your payment or refund obligation

GET
/payments/{operationId}

Authorization

PartnerApiKey
headerAuthorizationBearer <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.

Path Parameters

operationId*string
Formatuuid

Response Body

Operation status, amount, external_user_ref and parent_id. No signed transaction bytes are exposed.

application/json
  1. response
success*boolean
data*
Example Request
curl -X GET 'https://api-staging.theverity.xyz/api/v1/platform/payments/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -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",    "kind": "native_purchase",    "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef",    "external_user_ref": "string"  }}