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 |
Acquirer |
|
Unsuccessful transaction |
Purchase |
Acquirer |
|
Paid by other means |
Purchase |
Acquirer |
|
Canceled subscription |
Purchase |
Acquirer |
|
Defective merchandise |
Purchase |
Acquirer |
|
Technical error |
Purchase |
Acquirer |
|
Non-receipt of cash at ATM |
ATM withdrawal |
Acquirer |
|
Credit not received |
Refund |
Issuer |
|
Non-receipt of P2P transfer |
Cash-to-Card |
Issuer |
|
Request for sender information |
Cash-to-Card |
Acquirer |
|
Refusal of credit |
Cash-to-Card |
Acquirer |
|
Credit not processed |
Purchase |
Acquirer |
|
Dynamic currency conversion |
Purchase |
Acquirer |
|
Cash not credited |
Card Status Inquiry |
Acquirer | Refund |
Decline | |||
Incorrect operation amount |
Purchase Quick purchase |
Acquirer | Refund |
Decline | |||
Addendum Charge |
Purchase |
Acquirer | Refund |
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 |
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 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 |
|
|||
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 |
Default value |
---|---|---|---|---|
Execution option |
f_ResponseType |
Yes |
||
Refund option |
f_RefundType |
Yes if Execution option is Credit processed |
||
Refund transaction |
f_RefundTrx |
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 |
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 |
|||
List of services/works |
f_PrchDescAttach_Service |
|||
Delivery operator |
f_DeliveryOperator |
Row |
||
Tracking |
f_DeliveryTrackNo |
Row |
||
Delivery receipt |
f_DeliveryReceipt |
|||
Validation type |
f_qck_CheckType |
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 |
|||
Fiscal sales receipt |
f_CheckFiscal |
|||
Validation type |
f_wdr_CheckType |
Yes if Execution option is Successful transaction and Transaction type is ATM withdrawal |
||
ATM log |
f_wdr_AtmLog |
Yes if Execution option is Successful transaction and Transaction type is ATM withdrawal |
||
Video footage |
f_wdr_CameraShots |
|||
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 |
||
|
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 |
|||
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 |
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 |
Transaction type is Cash-to-Card | ||
f_crdi_Statement | 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 |
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 |
|
||
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 |