Chargeback Representment Upload

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 NameTypeRequiredDescription
chargeback_idstringrequiredThe event ID in CB911.
midstringoptionalSend 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'