Get Transaction Webhook Payload

Fetch the current webhook payload for a withdrawal transaction by its ID. Use this to manually sync your system if a webhook delivery was missed.

Endpoint

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

Path Parameters

Parameter	Type	Required	Description
transactionId	string	Yes	UUID of the transaction to look up

Headers

Header	Required	Description
Authorization	Yes	Bearer <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

Field	Type	Description
data.eventType	string	Always WITHDRAWAL
data.status	string	Current transaction status. See statuses below.
data.payload	object	Full webhook payload identical to what would be sent to your registered webhook

Transaction Statuses

Status	Meaning
PENDING	Withdrawal initiated, not yet submitted to payment network
PROCESSING_PAY_OUT	ACH or RTP accepted by the network; awaiting final settlement
SUCCESS	Payout settled; funds delivered to recipient
FAILED	Payout failed; see payload.reason for a merchant-safe explanation

Reason Values (on FAILED)

payload.reason	Scenario
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
}

Situation	HTTP	Message
Missing or invalid token	401	Unauthorized
Transaction not found or belongs to another merchant	404	Transaction not found
Transaction is not a withdrawal/payout	422	Webhook 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).