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

Acquirer

Refund

Decline

Unsuccessful transaction

Purchase
Quick purchase
ECOM purchase
Cash disbursement
Funding

Acquirer

Refund

Decline

Paid by other means

Purchase
Quick purchase
ECOM purchase

Acquirer

Refund

Decline

Canceled subscription

Purchase
Quick purchase
ECOM purchase

Acquirer

Refund

Decline

Defective merchandise

Purchase
Quick purchase
ECOM purchase

Acquirer

Refund

Decline

Technical error

Purchase
Quick purchase
ECOM purchase
ATM withdrawal
Cash disbursement
Funding

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
Refund

Acquirer

Provide information

 

Credit not processed 

Purchase
Quick purchase
ECOM purchase  

Acquirer  

 Refund

 Decline

Dynamic currency conversion

Purchase
ECOM purchase
ATM withdrawal

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.

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

   

Auth code

       


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

Default value

Execution option

f_ResponseType

InfoResponseType

Yes

 

Crediting date

f_CreditDate

Date

Yes if Execution option is Refund credited

 

Justification

f_Reason

Row

Yes if Execution option is Credit not received

 

Account statement

f_Statement

Files

   

Recipient’s full name

f_recipient_FIO

Row

   

Type of electronic payment instrument of the originator

f_OrigAccountType

EPaymentMethod

Yes if Execution option is Recipient information

 

PAN

f_OrigCardNumber

Digits(13,19)

Yes if Type of electronic payment instrument of the originator is Payment card

 

Account number

f_OrigBankAccNumber

Digits(20,20)

Yes if Type of electronic payment instrument of the originator is Bank account

 

Russian Central Bank Identifier Code

f_OrigBIC

Digits(9,9)

Yes if Type of electronic payment instrument of the originator is Bank account

 

Wallet provider

f_OrigWalletProvider

Row

Yes if Type of electronic payment instrument of the originator is E-wallet

 

Wallet number

f_OrigWalletAccountNumber

Row

Yes if Type of electronic payment instrument of the originator is E-wallet

 

Electronic payment instrument type

f_OrigOthAccType

Row

Yes if Type of electronic payment instrument of the originator is Other

 

Electronic payment instrument provider

f_OrigOthProvider

Row

Yes if Type of electronic payment instrument of the originator is Other

 

Electronic payment instrument number

f_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

   

Validation code

       


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

MirCard

To the Mir card

OtherPsCard

To a card of another PS

OtherMethod

By other means


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