v1
latestSwagger 2.02026-07-1415198294.2 KBMerchant Refund
Initiates a Mastercard Merchant Presented QR Refund transaction by pushing funds from a merchant account back to the customer's account.
Initiates a Mastercard Merchant Presented QR Refund transaction by pushing funds from a merchant account back to the customer's account.
post/send/#env/v1/partners/{partnerId}/merchant/transfers/refund
Path parameters
partnerIdstring required
Path Param - Provider assigned partner id. Details - string, 32
Request body
Example request
{
"merchant_refund_transfer": {
"additional_message": "DEV123456",
"amount": "5300",
"authentication_value": "ucaf: jJJLtQa+Iws8AREAEbjsA1MAAAA",
"channel": "WEB",
"currency": "USD",
"device_id": "DEV123456",
"digital_account_reference_number": "pan:5234568000001234",
"funding_source": "DEBIT",
"interchange_rate_designator": "QR",
"location": "state:MO",
"mastercard_assigned_id": "111111",
"participant": {
"card_acceptor_id": "CardAcceptor1",
"card_acceptor_name": "THE BEST BANK"
},
"participation_id": "TERMINAL34728",
"payment_origination_country": "USA",
"payment_transaction_reference": {
"network": "MASTERCARDSEND"
},
"payment_type": "MRF",
"processor_id": "2147483647",
"recipient": {
"additional_merchant_data": {
"sub_merchant_id": "A1234D"
},
"address": {
"city": "St. Louis",
"country": "USA",
"country_subdivision": "MO",
"line1": "435 Tucker St",
"line2": "Apartment 9",
"postal_code": "63103"
},
"email": "john.smith123@abcmail.com",
"first_name": "John",
"last_name": "Jones",
"merchant_category_code": "0763",
"middle_name": "Tyler",
"phone": "2147483647"
},
"reconciliation_data": {
"custom_field": [
{
"name": "TransactionID",
"value": "456FDWBS43"
}
]
},
"routing_transit_number": "965730000",
"sender": {
"address": {
"city": "Chicago",
"country": "USA",
"country_subdivision": "IL",
"line1": "123 Elm St",
"line2": "Apartment 9",
"postal_code": "60618"
},
"date_of_birth": "1999-12-30",
"email": "jane.smith123@abcmail.com",
"first_name": "John",
"last_name": "Jones",
"merchant_category_code": "0763",
"middle_name": "Tyler",
"phone": "12125551234"
},
"sender_account_uri": "pan:5299926000000542",
"token_cryptogram": {
"pan_sequence_number": "011",
"type": "CONTACTLESS_CHIP",
"value": "jjoutwsdgfdou124354ljlsdhgout968957"
},
"transaction_local_date_time": "2016-09-22T13:22:11-05:30",
"transfer_reference": "PAYMENT123456"
}
}Response
Response details for a merchant transfer.
Example response
{
"merchant_transfer": {
"channel": "WEB",
"created": "2016-09-22T13:22:11-05:30",
"device_id": "DEV123456",
"digital_account_reference_number": "pan:************1234",
"funding_source": "DEBIT",
"id": "mtrn_9abcd233jk23l6c5lw5f",
"interchange_rate_designator": "QR",
"location": "state:MO",
"original_status": "APPROVED",
"participant": {
"card_acceptor_id": "CardAcceptor1",
"card_acceptor_name": "THE BEST BANK"
},
"payment_origination_country": "USA",
"payment_type": "P2M",
"processor_id": "2147483647",
"recipient": {
"additional_merchant_data": {
"sub_merchant_id": "A1234D"
},
"address": {
"city": "OFallon",
"country": "USA",
"country_subdivision": "MO",
"line1": "1 Main St",
"line2": "Apartment 9",
"postal_code": "63368"
},
"email": "Jane.Smith123@abcmail.com",
"first_name": "John",
"last_name": "Jones",
"merchant_category_code": "0763",
"middle_name": "Tyler",
"phone": "11234567890"
},
"recipient_account_uri": "pan:************7372",
"reconciliation_data": {
"custom_field": [
{
"name": "TransactionID",
"value": "456FDWBS43"
}
]
},
"resource_type": "merchant_refund_transfer",
"routing_transit_number": "965730000",
"sender": {
"address": {
"city": "Chicago",
"country": "USA",
"country_subdivision": "IL",
"line1": "123 Elm St",
"line2": "Apartment 9",
"postal_code": "60618"
},
"date_of_birth": "1999-12-30",
"email": "jane.smith123@abcmail.com",
"first_name": "John",
"last_name": "Jones",
"middle_name": "Tyler",
"phone": "12125551234"
},
"sender_account_uri": "pan:************9012",
"status": "APPROVED",
"status_timestamp": "2016-09-22T13:22:11-05:30",
"transaction_history": {
"data": {
"transaction": [
{
"account_uri": "pan:************9012",
"authorization_id": "801726",
"create_timestamp": "2015-03-18T14:18:55Z",
"funds_availability": "IMMEDIATE",
"id": "trn_8h4me233jk23l6c5lw5f",
"network": "Mastercard",
"network_status_code": "54",
"network_status_description": "Expired Card",
"payment_account_reference": "5001ESVM4JQAAOP5JKSK1XGAPOPG2",
"resource_type": "transaction",
"retrieval_reference": "624200192616",
"status": "APPROVED",
"status_reason": "APPROVED",
"status_timestamp": "2015-03-18T14:18:56Z",
"switch_serial_number": "564727057",
"system_trace_audit_number": "926162",
"transaction_amount": {
"currency": "USD",
"value": "5300"
},
"type": "PAYMENT"
}
]
},
"resource_type": "list"
},
"transaction_local_date_time": "2016-09-22T13:22:11-05:30",
"transfer_amount": {
"currency": "USD",
"value": "5300"
},
"transfer_reference": "DEF123456"
}
}