Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.centryos.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Fetch the current webhook payload for any withdrawal transaction by its ID. Use this endpoint to manually sync your system if a webhook delivery was missed or delayed. The response is identical in shape to what is (or would be) sent to your registered webhook URL, built from the current state of the transaction.

​
Endpoint

  • Method: GET
  • URL: {{LIQUIDITY_URL}}/v1/transactions/:transactionId/webhook-payload
  • Auth: Bearer {{accessToken}} (merchant token)

​
Path Parameters

ParameterTypeRequiredDescription
transactionIdstringYesUUID of the transaction to look up

​
Request

curl -X GET "{{LIQUIDITY_URL}}/v1/transactions/7794112b-094e-443d-8454-7192aee10557/webhook-payload" \
  -H "Authorization: Bearer {{accessToken}}"

​
Response (200)

{
  "success": true,
  "data": {
    "eventType": "WITHDRAWAL",
    "status": "SUCCESS",
    "payload": {
      "description": "Payment sent",
      "method": "BANK_TRANSFER",
      "transactionId": "7794112b-094e-443d-8454-7192aee10557",
      "walletId": "44805633-c437-4140-a312-0e626c6feb19",
      "entityId": "9b5e1e96-5796-4648-94d4-62253728291e",
      "entityType": "USER",
      "summary": "Payment sent",
      "entry": "DEBIT",
      "amount": 20.87,
      "currency": "USD",
      "timestamp": 1771347650000,
      "feeCharged": "2.04174",
      "reason": ""
    }
  }
}

​
Response Fields

FieldTypeDescription
data.eventTypestringAlways WITHDRAWAL
data.statusstringCurrent transaction status (PENDING, PROCESSING_PAY_OUT, SUCCESS, FAILED)
data.payloadobjectFull webhook payload — same structure as the live webhook event
See Withdrawal Event for a complete breakdown of the payload fields and all possible status and reason values.

​
Error Responses

{
  "success": false,
  "message": "<error detail>",
  "fatal": true
}
SituationHTTPMessage
Missing or invalid token401Unauthorized
Transaction not found or belongs to another merchant404Transaction not found
Transaction is not a withdrawal/payout type422Webhook payload not available for this transaction type

​
Notes

  • Only returns transactions that belong to the authenticated merchant. Requesting another merchant’s transaction returns 404.
  • The timestamp in the response reflects when you called this endpoint, not when the original webhook was fired.
  • Only supported for payout/withdrawal transactions. Collection transactions are not available via this endpoint.