Dispute Chargebacks

Dispute Chargeback

PATCH https://api.synapsefi.com/v3.1/trans/:tran_id/dispute-chargeback

This endpoint allows you to dispute a chargeback that you received on Interchange Transactions.

Path Parameters

NameTypeDescription

tran_id

string

ID of the transaction.

Headers

NameTypeDescription

X-SP-USER

string

User's OAuth key and device fingerprint, separated by a pipe.

X-SP-USER-IP

string

IP address of your device.

X-SP-GATEWAY

string

Your Client ID and Secret, separated by a pipe.

Request Body

NameTypeDescription

docs

array

Array of base64 objects of evidence submitted for disputing chargeback. The file types accepted are JPEG, PNG, WEBP, TIFF, BMP, GIF and PDF.

{
    "_id": {
        "$oid": "5ff2636f8430a8d531505493"
    },
    "_v": 2,
    "amount": {
        "amount": 10010,
        "currency": "cUSD"
    },
    "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFi"
    },
    "extra": {
        "asset": null,
        "created_on": {
            "$date": 1609720687750
        },
        "group_id": null,
        "ip": "255.127.79.76",
        "latlon": "unknown,unknown",
        "location": {
            "address_city": null,
            "address_country_code": null,
            "address_postal_code": null,
            "address_subdivision": null,
            "lat": 0,
            "lon": 0
        },
        "note": "Test transaction",
        "other": {
            "affect_limits": true,
            "attachments": [
                "https://cdn.synapsepay.com/uploads/2021/01/04/corRSd0iMgO09TE3e4ZNB21zKh5wIGXPpQsfDxWqtjanmlFACu.pdf"
            ],
            "chargeback_disputed": true,
            "dispute_form": null,
            "dispute_meta": {},
            "dispute_reason": null,
            "disputed": false,
            "is_provisional_credit": false
        },
        "process_on": {
            "$date": 1609720687750
        },
        "rate": null,
        "rate_limit": null,
        "same_day": false,
        "settlement_delay": 0,
        "supp_id": null,
        "tracking_number": null
    },
    "fees": [
        {
            "fee": 150,
            "note": "Synapse Facilitator Fee",
            "to": {
                "id": "55b3f8c686c2732b4c4e9df6"
            }
        }
    ],
    "from": {
        "id": "5fea74557e08871fafe897cf",
        "nickname": "My BofA Card",
        "type": "INTERCHANGE-US",
        "user": {
            "_id": "5fe50a777562960078d3a5c6",
            "legal_names": [
                "Test User"
            ]
        }
    },
    "recent_status": {
        "date": {
            "$date": 1609720760773
        },
        "note": "[Returned on Debit] IR999 -- Stuff",
        "status": "RETURNED",
        "status_id": "6"
    },
    "timeline": [
        {
            "date": {
                "$date": 1609720687750
            },
            "note": "Transaction Created.",
            "status": "CREATED",
            "status_id": "1"
        },
        {
            "date": {
                "$date": 1609720689787
            },
            "note": " Approval Code 392270",
            "status": "PROCESSING-DEBIT",
            "status_id": "2"
        },
        {
            "date": {
                "$date": 1609720692716
            },
            "note": "",
            "status": "PROCESSING-CREDIT",
            "status_id": "3"
        },
        {
            "date": {
                "$date": 1609720693768
            },
            "note": "",
            "status": "SETTLED",
            "status_id": "4"
        },
        {
            "date": {
                "$date": 1609720760773
            },
            "note": "[Returned on Debit] IR999 -- Stuff",
            "status": "RETURNED",
            "status_id": "6"
        }
    ],
    "to": {
        "id": "5fe96562c54d7b7bcda9b9da",
        "nickname": "My Deposit Account",
        "type": "DEPOSIT-US",
        "user": {
            "_id": "5fe50a777562960078d3a5c6",
            "legal_names": [
                "Test User"
            ]
        }
    }
}

Example Request

Only INTERCHANGE-US transactions that have been RETURNED within the last 14 days with return code of IR999 can be disputed.

If dispute is won, the transaction will go back to SETTLED status. We recommend Subscribing to our webhooks to be notified.

PATCH /v3.1/trans/5ff2636f8430a8d531505493/dispute-chargeback HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
Content-Type: application/json

{
 "docs": [
   "data:application/pdf;base64,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Cjw8IC9UeXBlIC9QYWdlcyAvTWVkaWFCb3ggWzAgMCA2MTIgNzkyXSAvQ291bnQgMSAvS2lkcyBbIDIgMCBSIF0gPj4KZW5kb2JqCjE0IDAgb2JqCjw8IC9UeXBlIC9DYXRhbG9nIC9QYWdlcyAzIDAgUiAvVmVyc2lvbiAvMS40ID4+CmVuZG9iagoxIDAgb2JqCjw8IC9UaXRsZSAoU2NyZWVuIFNob3QgMjAyMC0xMi0yOSBhdCA3LjA5LjQwIEFNKSAvUHJvZHVjZXIgKG1hY09TIFZlcnNpb24gMTAuMTUuNiBcKEJ1aWxkIDE5RzczXCkgUXVhcnR6IFBERkNvbnRleHQpCi9DcmVhdG9yIChQcmV2aWV3KSAvQ3JlYXRpb25EYXRlIChEOjIwMjAxMjI5MTUxMDA3WjAwJzAwJykgL01vZERhdGUgKEQ6MjAyMDEyMjkxNTEwMDdaMDAnMDAnKQo+PgplbmRvYmoKeHJlZgowIDE1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwNDY0MCAwMDAwMCBuIAowMDAwMDAwMTg5IDAwMDAwIG4gCjAwMDAwMDQ0OTMgMDAwMDAgbiAKMDAwMDAwMDAyMiAwMDAwMCBuIAowMDAwMDAwMTcxIDAwMDAwIG4gCjAwMDAwMDAyOTMgMDAwMDAgbiAKMDAwMDAwMDM4MiAwMDAwMCBuIAowMDAwMDAwODA2IDAwMDAwIG4gCjAwMDAwMDQ0NTcgMDAwMDAgbiAKMDAwMDAwMDgyNSAwMDAwMCBuIAowMDAwMDAxMTAyIDAwMDAwIG4gCjAwMDAwMDExMjEgMDAwMDAgbiAKMDAwMDAwNDQzNiAwMDAwMCBuIAowMDAwMDA0NTc2IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMTUgL1Jvb3QgMTQgMCBSIC9JbmZvIDEgMCBSIC9JRCBbIDxjNmIwZGU5OTVjODIyZjNjNWI4MDBiMWM1YzY5YjZlZj4KPGM2YjBkZTk5NWM4MjJmM2M1YjgwMGIxYzVjNjliNmVmPiBdID4+CnN0YXJ0eHJlZgo0ODY5CiUlRU9GCg=="
 ]
}

Last updated