Dispute API
- Product review
- Documents
  - Authentication Service
    - Login Method ValidateToken Method Logout Method
  - BpEngineApi Service
    - CreateBp Method Download Method Upload Method GetBpItem Method GetBpList Method ProcessAction Method Method GetBpItemActions Method ProccessMerchantStageAction GetComments Method AddComment Method
  - Reporting Service
    - Disputes Method
  - Business logic
    - Dispute case
      - Dispute Case Incoming Case Response Review of the Response Cooling-off Period
    - Fraud case
      - Fraud Case Response to a Case Review of the response Review of the Issuer’s response Cooling-off period
    - Compliance case
      - Compliance Case Response to a Case Review of the response Cooling-off period
    - Good Faith case
      - Good Faith case Responce Good Faith case
  - Service SiomAPI
    - Method GetDetail Method GetPacketStatus Method Send Method GetSiomList
- Technical support
Search

Dispute API documentation

Dispute case

Incoming Case Response

Depending on transaction type and case reason, different answers are possible. E.g., a receiving Acquirer, in response to an incoming dispute over a purchase transaction for reason Goods or services not received, can either give a refund (if the goods really have not been delivered to the customer) or decline the dispute while providing the information that the customer did in fact receive the goods.

Reason of request	Transaction type	Recipient	Response option
Goods or services not received	Purchase Quick purchase ECOM purchase Funding Purchase with Cash Back	Acquirer	Refund
Goods or services not received		Acquirer	Decline
Unsuccessful transaction	Purchase Quick purchase ECOM purchase Cash disbursement Funding Purchase with Cash Back	Acquirer	Refund
Unsuccessful transaction		Acquirer	Decline
Paid by other means	Purchase Quick purchase ECOM purchase Purchase with Cash Back	Acquirer	Refund
Paid by other means		Acquirer	Decline
Canceled subscription	Purchase Quick purchase ECOM purchase Purchase with Cash Back	Acquirer	Refund
Canceled subscription		Acquirer	Decline
Defective merchandise	Purchase Quick purchase ECOM purchase Purchase with Cash Back	Acquirer	Refund
Defective merchandise		Acquirer	Decline
Technical error	Purchase Quick purchase ECOM purchase ATM withdrawal Cash disbursement Funding Purchase with Cash Back	Acquirer	Refund
Technical error		Acquirer	Decline
Non-receipt of cash at ATM	ATM withdrawal	Acquirer	Refund
Non-receipt of cash at ATM	ATM withdrawal	Acquirer	Decline
Credit not received	Refund	Issuer	Provide information
Non-receipt of P2P transfer	Cash-to-Card Card-to-Card	Issuer	Provide information
Request for sender information	Cash-to-Card Card-to-Card	Acquirer	Provide information
Refusal of credit	Cash-to-Card Card-to-Card Refund	Acquirer	Provide information
Refusal of credit	Cash-to-Card Card-to-Card Refund	Acquirer
Credit not processed	Purchase Quick purchase ECOM purchase Purchase with Cash Back	Acquirer	Refund
Credit not processed		Acquirer	Decline
Dynamic currency conversion	Purchase ECOM purchase ATM withdrawal	Acquirer	Refund
Dynamic currency conversion	Purchase ECOM purchase ATM withdrawal	Acquirer	Decline
Cash not credited	Card Status Inquiry	Acquirer	Refund
Cash not credited	Card Status Inquiry	Acquirer	Decline
Incorrect operation amount	Purchase Quick purchase ECOM purchase	Acquirer	Refund
Incorrect operation amount	Purchase Quick purchase ECOM purchase	Acquirer	Decline
Addendum Charge	Purchase ECOM purchase	Acquirer	Refund
Addendum Charge	Purchase ECOM purchase	Acquirer	Decline

Refund Response

To perform a Refund, send to ProcessAction method the actionCode - a_MakeAdjustment and the following fields:

Field	Code	Data type	Necessity	Default value	Comments
Adjustment amount	f_AdjAmount	Money	Yes	Dispute amount	For the reason Dynamic Currency Conversion, the adjustment amount must equal the dispute amount, partial refund is not possible. For the transaction type "Purchase with Cash Back", for the case reasons for launching "Unsuccessful Transaction", "Paid by Other Means", "Non-receipt of Cash at ATM", Violation of the technology of the transaction ": The refund amount must be equal to the dispute amount. For the transaction type "Purchase with CashBack", for the case reason "Goods or Services Not Received" and dispute condition "Goods not received (service not provided) and cash not received" the refund amount must be equal to the dispute amount, partial refund is not possible.
Amount justification	f_Reason	Text	Yes if Adjustment amount is less than Dispute amount
Documents	f_Docs	Files
Comments	f_Comment	Row

Decline Response

To perform a Decline, send to ProcessAction method the actionCode - a_DeclineDispute and the following fields:

Initiation form	Code	Data type	Necessity
Execution option	f_ResponseType	DeclineResponseType	Yes
Refund option	f_RefundType	RefundType	Yes if Execution option is Credit processed
Refund transaction	f_RefundTrx	Operation	Yes if Refund option is To Mir/ MC/Visa card
Refund transaction PAN	f_RefundPan	Digits(13,19)
Refund transaction ARN	f_RefundArn	Digits(23,23)
Refund amount	f_RefundAmount	Money	Yes if Refund option is To the card of another PS
Refund transaction business date	f_RefundDate	Date	Yes if Refund option is To the card of another PS
Refund description	f_CustomRefund	Row	Yes if Refund option is By other means
Explanation	f_RefundExplanation	Row	Yes if Refund amount differs from Transaction amount
Delivery date	f_FactDeliveryDate	Date	Yes if Case Reason is Goods or services not received and Purchase type is Goods
Date of services / works delivery	f_FactServiceDate	Date	Yes if Case Reason is Goods or services not received and Purchase type is Service/Works
List of goods	f_PrchDescAttach_Goods	Files
List of services/works	f_PrchDescAttach_Service	Files
Delivery operator	f_DeliveryOperator	Row
Tracking	f_DeliveryTrackNo	Row
Delivery receipt	f_DeliveryReceipt	Files
Validation type	f_qck_CheckType	QckCheckType	Yes if Execution option is Successful transaction and Transaction type is Quick purchase
Verification description	f_qck_CustomCheckType	Row	Yes if Validation type is Other
Purchase description	f_PurchaseDescription	Row
Terminal receipt	f_CheckTerm	Files
Fiscal sales receipt	f_CheckFiscal	Files
Validation type	f_wdr_CheckType	WdrCheckType	Yes if Execution option is Successful transaction and Transaction type is ATM withdrawal
ATM log	f_wdr_AtmLog	Files	Yes if Execution option is Successful transaction and Transaction type is ATM withdrawal
Video footage	f_wdr_CameraShots	Files
Justification	f_CorrectReason	Row	Yes if Execution option is Correct transaction technology or Dispute not justified
Description	f_cdb_PvnDesc	Row
Address	f_cdb_PvnAddress	Row
Name	f_fund_MerchantName	Row
Website	f_fund_MerchantWebsite	Row
Phone number	f_fund_MerchantPhone	Row
E-mail	f_fund_MerchantEmail	Row
Recipient information	f_fund_TransferDestinator	Row
Type of electronic payment instrument of the recipient	f_fund_DestAccountType	Row
PAN	f_fund_DestCardNumber	Digits(13,19)
Account number	f_fund_DestBankAccNumber	Digits(20,20)
Russian Central Bank Identifier Code	f_fund_DestBIC	Digits(9,9)
Wallet provider	f_fund_DestWalletProvider	Row
Wallet number	f_fund_DestWalletAccountNumber	Row
Electronic payment instrument type	f_fund_DestOthAccType	Row
Electronic payment instrument provider	f_fund_DestOthProvider	Row
Electronic payment instrument number	f_fund_DestOthAccNumber	Row
Recipient’s full name	f_fund_FIO	Row
Documents	f_Docs	Files
Comments	f_Comment	Row

Provide Information Response

To perform a Provide Information action, send to ProcessAction method the actionCode - a_ProvideInfo and the following fields:

Initiation form	Code	Data type	Necessity	Comments
Execution option	f_ResponseType	InfoResponseType	Yes
Crediting date	f_rfi_CreditDate	Date	Yes if Execution option is Refund credited
	f_cshi_CreditDate		Yes if Execution option is Destinator сredited and Transaction type is Cash-to-Card
	f_crdi_CreditDate		Yes if Execution option is Destinator сredited and Transaction type is Card-to-Card
Justification	f_rfi_Reason	Row	Yes if Execution option is Refund not credited
	f_cshi_Reason		Yes if Execution option is Destinator not credited and Transaction type is Cash-to-Card
	f_crdi_Reason		Yes if Execution option is Destinator not credited and Transaction type is Card-to-Card
Account statement	f_cshi_Statement	Files		Transaction type is Cash-to-Card
Account statement	f_crdi_Statement	Files		Transaction type is Card-to-Card
Recipient’s full name	f_recipient_FIO	Row
Type of electronic payment instrument of the originator	f_crda_OrigAccountType	EPaymentMethod	Yes if Execution option is Recipient information
PAN	f_crda_OrigCardNumber	Digits(13,19)	Yes if Type of electronic payment instrument of the originator is Payment card
Account number	f_crda_OrigBankAccNumber	Digits(20,20)	Yes if Type of electronic payment instrument of the originator is Bank account
Russian Central Bank Identifier Code	f_crda_OrigBIC	Digits(9,9)	Yes if Type of electronic payment instrument of the originator is Bank account
Wallet provider	f_crda_OrigWalletProvider	Row	Yes if Type of electronic payment instrument of the originator is E-wallet
Wallet number	f_crda_OrigWalletAccountNumber	Row	Yes if Type of electronic payment instrument of the originator is E-wallet
Electronic payment instrument type	f_crda_OrigOthAccType	Row	Yes if Type of electronic payment instrument of the originator is Other
Electronic payment instrument provider	f_crda_OrigOthProvider	Row	Yes if Type of electronic payment instrument of the originator is Other
Electronic payment instrument number	f_crda_OrigOthAccNumber	Row	Yes if Type of electronic payment instrument of the originator is Other
Full name of the originator	f_funding_FIO	Row
Phone number of the originator	f_OrigPhone	Row
Documents	f_Docs	Files
Comments	f_Comment	Row

Listings

InfoResponseType Listing

Code	Value
RefundCredited	Refund credited
RefundNotCredited	Credit not received
DestinatorCredited	Refund credited
DestinatorNotCredited	Credit not received
OriginatorInfo	Originator information

DeclineResponseType Listing

Code	Value
RefundHandled	Credit processed
TrxSucceeded	Transaction Successful
TechInfo	Correct transaction technology
DisputeNotValid	Dispute not justified

EPaymentMethod Listing

Code	Value
PaymentCard	Payment card
OnlineWallet	E-wallet
BankAccount	Bank account
Other	Other

RefundType Listing

Code	Value
OtherMethod	By other means
BankCard	By Mir/MC/Visa card

QckCheckType Listing

Code	Value
FastCheck	A quick check in the processing system
Merchant	Contacted the Merchant
Other	Other

WdrCheckType Listing

Code	Value
Encashment	A quick check in the processing system
TechAnalyse	Contacted the Merchant

Data Types

Money Type

Code	Data type	Value
amount	Decimal	Amount
currencyCode	Row	Numeric currency code according to the Russian Classification of Currencies (e.g., the Russian ruble is 643)

File Type

Code	Data type	Value
fileName	Row	File name
content	Row	File content in base64

Operation Type

Parameter	Data type	Description
pan	Row	PAN
arn	Row	Transaction number
cpd	Date	Business date