API Products of the Mir payment system

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

Decline

Unsuccessful transaction

Purchase
Quick purchase
ECOM purchase
Cash disbursement
Funding
Purchase with Cash Back

Acquirer

Refund

Decline

Paid by other means

Purchase
Quick purchase
ECOM purchase
Purchase with Cash Back

Acquirer

Refund

Decline

Canceled subscription

Purchase
Quick purchase
ECOM purchase
Purchase with Cash Back

Acquirer

Refund

Decline

Defective merchandise

Purchase
Quick purchase
ECOM purchase
Purchase with Cash Back

Acquirer

Refund

Decline

Technical error

Purchase
Quick purchase
ECOM purchase
ATM withdrawal
Cash disbursement
Funding
Purchase with Cash Back

Acquirer

Refund

Decline

Non-receipt of cash at ATM

ATM withdrawal

Acquirer

Refund

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

 

Credit not processed 

Purchase
Quick purchase
ECOM purchase
Purchase with Cash Back 

Acquirer  

Refund

Decline

Dynamic currency conversion

Purchase
ECOM purchase
ATM withdrawal

Acquirer  

Refund

Decline

Cash not credited

Card Status Inquiry

Acquirer   Refund
Decline
Incorrect operation amount

Purchase

Quick purchase
ECOM purchase

Acquirer   Refund
Decline
Addendum Charge

Purchase
ECOM 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

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

Default value

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
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

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