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

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	AnswerType	Yes	Provide Information
Refund option	f_RefundType	RefundType	Yes if Response option is Credit processed
Refund transaction	f_RefundTrx	Operation	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	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
Evidence description	f_Evidence	Row	Yes if Response option is Evidence description
Documents	f_Docs	Files
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	AnswerType	Yes	Provide Information	The value Credit processed is only valid for Purchase and ECOM purchase types of transactions
Fiscal sales receipt	f_CheckFiscal	Files	Yes
Terminal receipt	f_CheckTerm	Files	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	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	Files
Recipient’s full name	f_FIO	Row
List of goods	f_GoodsList	Files	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
E-mail	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	Operation	Yes if Refund option is To the Mir card
Refund option	f_RefundType	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	Money	Yes	Dispute amount
Amount justification	f_Reason	Text	Yes if Adjustment amount is less than Dispute amount
Documents	f_Docs	Files
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	Files
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