Verify transaction
Verification guarantees you have received payment
After initializing a transaction, you transfer control to your customer to complete payment. Hence, online payments require you to always run a verification check even if you are informed that payment has been completed.
Transaction verification provides a way for you to confirm the status of a transaction. A transaction may be in a processing
state if payment processor networks are having a slow day. However, once a transaction is completed, a verification request will let you know if it was successful or failed.
The reference of the transaction to retrieve
Returns 200 and the requested transaction
Returns 400 if the query is invalid
Returns 401 when authorization details is invalid
Returns 404 if a transaction with the specified id is not found
GET /v1/transactions/verify/{tx_ref} HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"status": "success",
"message": "text",
"data": {
"id": "text",
"is_live": true,
"gateway_code": "text",
"tx_ref": "text",
"dedicated_virtual_account_reference": "text",
"currency": "text",
"amount": 1,
"charged_amount": 1,
"amount_settled": 1,
"app_fee": 1,
"merchant_fee": 1,
"bearer": "customer",
"status": "successful",
"metadata": "text",
"redirect_url": "text",
"payment_type": "text",
"is_direct_card_charge": true,
"is_virtual_account_checkout": true,
"is_dedicated_virtual_account_checkout": true,
"device_fingerprint": "text",
"ip": "text",
"narration": "text",
"processor_response": "text",
"auth_model": "text",
"card_pan": "text",
"card_issuer": "text",
"card_country": "text",
"card_type": "text",
"card_expiry": "text",
"bank_trsf_country": "text",
"bank_trsf_bank_code": "text",
"bank_trsf_bank_name": "text",
"bank_trsf_account_number": "text",
"bank_trsf_account_name": "text",
"bank_trsf_swift": "text",
"bank_trsf_iban": "text",
"bank_trsf_session_id": "text",
"title": "text",
"logo_url": "text",
"description": "text",
"customer": {
"id": "text",
"full_name": "text",
"email": "text",
"phone_number": "text",
"address": "text",
"status": "active",
"created_at": "2025-09-10T05:34:53.272Z",
"edited_at": "2025-09-10T05:34:53.272Z"
},
"paid_at": "2025-09-10T05:34:53.272Z",
"created_at": "2025-09-10T05:34:53.272Z",
"edited_at": "2025-09-10T05:34:53.272Z",
"transaction_payout_tags": [
{
"payout_tag": "text",
"amount": 1,
"description": "text",
"metadata": "text"
}
],
"virtual_account_transfer_timeline_entries": [
{
"id": "text",
"action_type": "awaitingProviderResponse",
"action": "text",
"description": "text",
"gateway_code": "text",
"is_live": true,
"created_at": "2025-09-10T05:34:53.272Z",
"edited_at": "2025-09-10T05:34:53.272Z"
}
]
},
"meta": {},
"errors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"is_error": true
}
curl https://api.switchappgo.com/v1/transactions/verify/{reference} \
-H "authorization: 'bearer sk_test_nTgS42KNdKr6Ts798DT'"
-X GET
Last updated