This API allows you to upload representments and the necessary information to challenge transactions easily. This simplifies the process of challenging a shopper's claim of an illegitimate transaction charged to their account.
Endpoint
https://ws.bluesnap.com/services/2/chargeback/upload_representment
Request Content
This endpoint accepts chargeback_id
and mid
as query string parameters and a representment file as evidence of your chargeback dispute.
Query String Parameters
Parameter Name | Type | Required | Description |
---|---|---|---|
chargeback_id | string | required | The event ID in CB911. |
mid | string | optional | Send only if the request is on behalf of a linked BlueSnap account. |
Representment File
You need to upload a representment file that contains evidence to challenge the chargeback. This file has the following requirements:
- The request should be multipart/form-data
- In the body part containing the file, the Content-Disposition header should be "representment_file"
- PDF and TIFF are the accepted file formats
- The file size limit on production is 9MB
- The file size limit on sandbox is 0.2MB
- Multiple files should be uploaded separately, each one in a separate request
- On production, only one upload is allowed per case
For a sample form, refer to this Chargeback Response Template.
Response Details
If successful, the response HTTP status code is 200 OK.
Examples
Request Examples
curl -v -X POST https://ws.bluesnap.com/services/2/chargeback/upload_representment?chargeback_id=154 \
--H 'Authorization: Basic QVBJXzE0NDQ2NTAyMDMxNDQ5NDA0MjIzNjU6QkxVRTEyMw==' \
--H 'Content-Type: multipart/form-data'
--F 'representment_file=path/to/file.pdf'
curl -v -X POST https://ws.bluesnap.com/services/2/chargeback/upload_representment?chargeback_id=154&mid=256425 \
--H 'Authorization: Basic QVBJXzE0NDQ2NTAyMDMxNDQ5NDA0MjIzNjU6QkxVRTEyMw==' \
--H 'Content-Type: multipart/form-data'
--F 'representment_file=path/to/file.pdf'