API Products of the Mir payment system

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