Dispute Reversal
Submit an investigation request for duplicate debits or contested transfers. Requires developer encrypted PIN.
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
Content-Type | string | Required | application/json |
POST/v1/wallet/reversalLive & Sandbox
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
transactionReference | string | Required | Ledger reference to reverse |
reason | string | Required | Dispute or correction reason |
transactionPin | string | Required | RSA-OAEP encrypted PIN |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Request Example
curl -X POST https://developer.vixzz.com/v1/wallet/reversal \
-H "Authorization: Bearer vxz_tok_c2b_8f9k3m9s2a1l" \
-H "Content-Type: application/json" \
-d '{
"transactionId": "TXN_C2B_84920199",
"encryptedPin": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3f9k2L9...",
"reason": "DUPLICATE_DEBIT_DISPUTE",
"disputeEvidenceUrl": "https://example.com/evidence/doc_8819.pdf"
}'JSON Return Response Body (200 OK)
Response
{
"disputeId": "DISP_VXZ_881920",
"transactionId": "TXN_C2B_84920199",
"status": "UNDER_REVIEW",
"estimatedResolutionHours": 24
}