v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Migration

Create dispute migration

Create a migration for a Full balance or Zero balance program.

After this, you can create a dispute migration for a specific installment using the dispute ID returned here.

This endpoint generates a Dispute installment created event. Once the dispute is migrated into the system, its status changes and a Dispute status changed event is generated.

post/v1/migration

Request body

chargeback_idstring required

Chargeback ID, same as dispute ID for VISA.

claim_idstring required

Claim ID, same as case number for VISA.

disputed_amountnumber double required

Amount under dispute

network_brand_type'Visa' | 'Mastercard' | 'Elo' required

Network brand

authorization_idnumber

Authorization ID. REQUIRED for Full balance integration.

account_idnumber

Account ID. REQUIRED for Zero balance integration.

transaction_datestring

Transaction date, format = yyyy-mm-dd. REQUIRED for Zero balance integration.

arnstring

Acquirer reference number. REQUIRED for Zero balance integration.

is_partialboolean

Is partial amount chargeback? Default is false.

installment_disputed_amountnumber

Installent disputed amount

installment_numberinteger

Installment number.

Example request

{
  "chargeback_id": "4965860",
  "claim_id": "88993u748",
  "disputed_amount": 215,
  "network_brand_type": "Visa",
  "authorization_id": 8475859059,
  "account_id": 5894887,
  "transaction_date": "2023-02-23",
  "arn": "4096860",
  "installment_disputed_amount": 678,
  "installment_number": 1
}

Response

idnumber

Dispute ID

authorization_idnumber

Authorization ID. REQUIRED for Full balance integration.

account_idnumber

Account ID. REQUIRED for Zero balance integration.

commentstring nullable

Client custom dispute comment.

REQUIRED for Visa partial dispute to explain why partial.

reasonnumber

Each card network, such as Visa or Mastercard, defines and maintains their own unique set of reason codes, which banks that issue credit and debit cards under their brands apply to disputes. Here's a reason code quick reference for the major credit card networks.

For Visa, this would be either 10 (fraud - card present), 11 (authorization), 12 (processing error), or 13 (consumer dispute).

For more infomation, refer to the Visa or Mastercard chargeback quides.

For example - 4853 (Mastercard - cardholder dispute), 12 (Visa - processing error) or 72 (ELO - denied authorization)

dispute_installment_idinteger

Dispute installment ID.

Example response

{
  "id": 48670,
  "authorization_id": 8475859059,
  "comment": "Custom comment",
  "reason": 4853,
  "dispute_installment_id": 8675309
}