Dispute Reversal

Submit an investigation request for duplicate debits or contested transfers. Requires developer encrypted PIN.

Request Headers

HeaderTypeStatusDescription
AuthorizationstringRequiredBearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token)
Content-TypestringRequiredapplication/json
POST/v1/wallet/reversalLive & Sandbox

Body Parameters (JSON)

ParameterTypeStatusDescription
transactionReferencestringRequiredLedger reference to reverse
reasonstringRequiredDispute or correction reason
transactionPinstringRequiredRSA-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
}