Dispute API documentation
Fraud case
Response to a Case
Depending on the fraud liability automatically assigned by the system, different responses are possible.
Provide Information Response
To perform a Provide information action for a case the Acquirer is responsible for, send to ProcessAction method actionCode - a_ProveNotFraud and the following fields:
Initiation form | Code | Data type | Necessity | Default value |
---|---|---|---|---|
Response option |
f_AnswerType |
Yes |
Provide Information |
|
Refund option |
f_RefundType |
Yes if Response option is Credit processed |
|
|
Refund transaction |
f_RefundTrx |
Yes if Refund option is To the Mir card |
|
|
Refund transaction PAN |
f_RefundPan |
Digits(13,19) |
Yes if Refund option is To the card of another PS |
|
Refund transaction ARN |
f_RefundArn |
Digits(23,23) |
Yes if Refund option is To the card of another PS |
|
Refund transaction 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 |
|
Evidence description |
f_Evidence |
Row |
Yes if Response option is Evidence description |
|
Documents |
f_Docs |
|
|
|
Comments |
f_Comment |
Row |
|
|
To perform a Provide information action for a case the Issuer is responsible for, send to ProcessAction method actionCode - a_ProvideInfo and the following fields:
Initiation form | Code | Data type | Necessity | Default value | Comments |
---|---|---|---|---|---|
Response option |
f_AnswerType |
Yes |
Provide Information |
The value Credit processed is only valid for Purchase and ECOM purchase types of transactions |
|
Fiscal sales receipt |
f_CheckFiscal |
Yes |
|
|
|
Terminal receipt |
f_CheckTerm |
Yes if fields Purchase description, Fiscal sales receipt are not populated |
|
|
|
Comments |
f_Comment |
Row |
|
|
|
Refund description |
f_CustomRefund |
Row |
Yes if Refund option is By other means |
|
|
Merchant description |
f_LocationDescription |
Row |
Yes if Transaction type is Cash disbursement or ATM withdrawal |
|
|
Type of electronic payment instrument of the recipient |
f_DestAccountType |
Yes if Transaction type is Funding |
|
|
|
Account number |
f_DestBankAccNumber |
Row |
Yes if Type of electronic payment instrument of the recipient is Bank account |
|
|
Russian Central Bank Identifier Code |
f_DestBIC |
Row |
Yes if Type of electronic payment instrument of the recipient is Bank account |
|
|
PAN |
f_DestCardNumber |
Row |
Yes if Type of electronic payment instrument of the recipient is Payment card |
|
|
Electronic payment instrument number |
f_DestOthAccNumber |
Row |
Yes if Type of electronic payment instrument of the recipient is Other |
|
|
Electronic payment instrument type |
f_DestOthAccType |
Row |
Yes if Type of electronic payment instrument of the recipient is Other |
|
|
Electronic payment instrument provider |
f_DestOthProvider |
Row |
Yes if Type of electronic payment instrument of the recipient is Other |
|
|
Wallet number |
f_DestWalletAccountNumber |
Row |
Yes if Type of electronic payment instrument of the recipient is E-wallet |
|
|
Wallet provider |
f_DestWalletProvider |
Row |
Yes if Type of electronic payment instrument of the recipient is E-wallet |
|
|
Documents |
f_Docs |
|
|
|
|
Recipient’s full name |
f_FIO |
Row |
|
|
|
List of goods |
f_GoodsList |
Yes if Transaction type is ECOM purchase and field Purchase description is not populated |
|
|
|
Legal entity |
f_LegalEntity |
Row |
Yes |
|
|
Operational profile |
f_MerchantActivity |
Row |
|
|
|
Address |
f_MerchantAddress |
Row |
Yes if Transaction type is Purchase or Cash disbursement or ATM withdrawal |
|
|
|
f_MerchantEmail |
Row |
|
|
|
Name |
f_MerchantName |
Row |
Yes |
|
|
Phone number |
f_MerchantPhone |
Row |
|
|
|
Website |
f_MerchantWebsite |
Row |
Yes if Transaction type is Funding or ECOM purchase |
|
|
Purchase description |
f_PurchaseDescription |
Row |
Yes if Transaction type is Purchase and fields Terminal receipt, Fiscal sales receipt are not populated or if Transaction type is ECOM purchase and field List of goods is not populated |
|
|
Amount |
f_RefundAmount |
Row |
Yes if Refund option is To the card of another PS |
|
|
ARN |
f_RefundArn |
Digits(23,23) |
Yes if Refund option is To the card of another PS |
|
|
Business date |
f_RefundDate |
Date |
Yes if Refund option is To the card of another PS |
|
|
PAN |
f_RefundPan |
Digits(13,19) |
Yes if Refund option is To the card of another PS |
|
|
Refund transaction |
f_RefundTrx |
Yes if Refund option is To the Mir card |
|
|
|
Refund option |
f_RefundType |
Yes if Response option is Credit processed |
|
|
Refund Response
To perform a Refund, send to ProcessAction method the actionCode - a_MakeAdjustment and the following fields:
Initiation form | Code | Data type | Necessity | Default value |
---|---|---|---|---|
Adjustment amount |
f_CreditAdjAmount |
Yes |
Dispute amount |
|
Amount justification |
f_Reason |
Text |
Yes if Adjustment amount is less than Dispute amount |
|
Documents |
f_Docs |
|
|
|
Comments |
f_Comment |
Row |
|
|
Accept Fraud Response
To perform an Accept fraud action, send to ProcessAction method the actionCode - a_AcceptFraud and the following fields:
Initiation form | Code | Data type | Necessity | Default value |
---|---|---|---|---|
Documents |
f_Docs |
|
|
|
Comments |
f_Comment |
Row |
|
|
Listings
AnswerType Listing
Code | Value |
---|---|
ProvideInfo |
Provide Information |
RefundHandled |
Credit processed |
RefundType Listing
Code | Value |
---|---|
MirCard |
To the Mir card |
OtherPsCard |
To a card of another PS |
OtherMethod |
By other means |
DestAccountType Listing
Code | Value |
---|---|
PaymentCard |
Payment card |
OnlineWallet |
E-wallet |
BankAccount |
Bank account |
Other |
Other |
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 |