Skip to main content
POST
Transfer Status
Use this endpoint to check the final status of a transfer you created with either Initiate Transfer or Bulk Transfer.

Endpoint

POST /pms/api/external/request/wallet/transfer-status/

Request Body

string
Transfer reference you passed when initiating the transfer
string
Session ID returned in the initial transfer response

Example request

Example cURL

Response

The status field in data tells you whether the transfer is pending, success, or failed. Use this endpoint together with Initiate Transfer, Bulk Transfer, and wallet transaction history for full payout reconciliation.

Headers

api-key
string
required

Your Payvessel public API key

api-secret
string
required

Your Payvessel secret

Content-Type
enum<string>
required

Request content type

Available options:
application/json

Body

application/json
reference
string
required

Transfer reference

session_id
string
required

Session ID from initiation

Response

200 - application/json

Transfer status retrieved successfully

status
boolean

Request status

message
string

Response message

data
object

Transfer status data