Skip to main content
Check the final status of a transfer you created with Single Transfers or Bulk Transfers. Use this to confirm whether a payout completed successfully.

​
Usage

curl -X POST https://api.payvessel.com/pms/api/external/request/wallet/transfer-status/ \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "PAYOUT_2026_0001",
    "session_id": "SESSION_123456789"
  }'

​
Request body

FieldTypeRequiredDescription
referencestringNoThe unique reference you passed when initiating the transfer
session_idstringNoThe session ID returned in the initial transfer response

​
Response fields

FieldTypeDescription
referencestringYour transfer reference
session_idstringTransfer session ID
amountstringTransfer amount
statusstringpending, success, or failed
destination_account_numberstringRecipient account number
destination_bank_codestringRecipient bank code
destination_account_namestringRecipient account name
completed_atdatetimeWhen the transfer completed

API Reference

Full request/response details and Try it