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.

​
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

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <merchant access token>

​
Request

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

​
Response (200)

Returns the same payload structure that is sent to your registered webhook URL, reflecting the current state of the transaction. 
{
  "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. See statuses below.
data.payloadobjectFull webhook payload identical to what would be sent to your registered webhook

​
Transaction Statuses

StatusMeaning
PENDINGWithdrawal initiated, not yet submitted to payment network
PROCESSING_PAY_OUTACH or RTP accepted by the network; awaiting final settlement
SUCCESSPayout settled; funds delivered to recipient
FAILEDPayout failed; see payload.reason for a merchant-safe explanation

​
Reason Values (on FAILED)

payload.reasonScenario
Recipient account not found.Recipient’s bank account could not be located
Duplicate transaction detected.Duplicate payout was submitted
Transaction declined for compliance reasons.Declined due to compliance or business rules
Payment could not be processed.General processing failure
Your payment could not be processed. Please try a different card.Card-specific failure
Payment was cancelled.Payout was cancelled

​
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/payout422Webhook payload not available for this transaction type

​
Notes

  • Only returns transactions belonging to the authenticated merchant. Requesting another merchant’s transaction returns 404.
  • The timestamp in the response is the time the request was made, not when the original webhook fired.
  • Only supported for withdrawal/payout transactions (WITHDRAWAL, PAYMENT, PAYOUT flow types).