Skip to main content

Chargeback Disputes API Integration

Authentication​

We will provide you with a secret key you can use to authenticate with our endpoints. Authentication is done via the X-API-KEY header

Request Proof​

To request proof for use in chargeback disputes, create a ProofRequest

method: PUT

endpoint: https://api.dyneti.com/disputes/proofRequest

body:

["scan-id-1", "scan-id-2", ...]

response:

{
	id: "proof-request-id"
}

example:

curl -X PUT https://api.dyneti.com/disputes/proofRequest \
     -H "X-API-KEY: your-secret-key-here" \
     -H "Content-Type: application/json" \ 
     -d '["scan-id-1", "scan-id-2", "scan-id-3"]'

Check Proof Request Status​

method: GET

endpoint: https://api.dyneti.com/disputes/proof/<proof_request_id>

example:

curl -X GET https://api.dyneti.com/disputes/proof/your-proof-request-id-here \
     -H "X-API-KEY: your-secret-key-here"

If the request is not yet complete, the status will be pending:

{
	"status": "pending"
}

You can poll the request until the status is complete. We recommend an interval of a few hours.

If the request is complete, the status will be complete and the scans field will be present:

{
	"status": "complete",
	"scans": [
		{
			"scanId": "scan-id-1",
			"groundTruth": "valid" 
			"image": "https://api.dyneti.com/disputes/image/scan-id-1.jpg"
		},
{
			"scanId": "invalid-scan-id-1",
			"groundTruth": "fraud" 
		},
		...
	]
	
}

Please note: scans marked as “fraud” will not include an image url.