v1
latestSwagger 2.02026-07-1415198294.2 KBMerchant Transfer - Funding and Payment
Initiates a Mastercard Merchant Presented QR purchase transaction by securing funds from a consumer’s account with a Funding Transaction and pushing funds to a merchant account with a Payment Transaction.
Initiates a Mastercard Merchant Presented QR purchase transaction by securing funds from a consumer’s account with a Funding Transaction and pushing funds to a merchant account with a Payment Transaction.
post/send/#env/v1/partners/{partnerId}/merchant/transfer
Path parameters
partnerIdstring required
Path Param - Provider assigned partner id.
Type: Alphanumeric Special [a-zA-Z0-9_-], Length: 32
Request body
Example request
{
"merchant_transfer": {
"additional_message": "DEV123456",
"convenience_amount": "10",
"convenience_indicator": "01",
"digital_account_reference_number": "pan:5234568000001234",
"interchange_rate_designator": "QR",
"mastercard_assigned_id": "111111",
"participant": {
"card_acceptor_id": "CardAcceptor1",
"card_acceptor_name": "THE BEST BANK"
},
"participation_id": "TERMINAL34763",
"payment_origination_country": "USA",
"payment_type": "P2M",
"processor_id": "2147483647",
"qr_data": "001006XX123400201012353611110030073041233004008LYL44354005009EEB",
"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"
},
"authentication_value": "ucaf: jJJLtQa+Iws8AREAEbjsA1MAAAA",
"email": "john.smith123@abcmail.com",
"first_name": "John",
"last_name": "Jones",
"merchant_category_code": "0763",
"middle_name": "Tyler",
"phone": "2147483647",
"token_cryptogram": {
"pan_sequence_number": "011",
"type": "CONTACTLESS_CHIP",
"value": "jjoutwsdgfdou124354ljlsdhgout968957"
}
},
"recipient_account_uri": "pan:5125589999999905;exp=2019-08",
"reconciliation_data": {
"custom_field": [
{
"name": "TransactionID",
"value": "456FDWBS43"
}
]
},
"routing_transit_number": "965730000",
"sender": {
"additional_merchant_data": {
"sub_merchant_id": "A1234D"
},
"address": {
"city": "Chicago",
"country": "USA",
"country_subdivision": "IL",
"line1": "123 Elm St",
"line2": "Apartment 9",
"postal_code": "60618"
},
"authentication_value": "ucaf: jJJLtQa+Iws8AREAEbjsA1MAAAA",
"email": "jane.smith123@abcmail.com",
"first_name": "John",
"last_name": "Jones",
"middle_name": "Tyler",
"phone": "2147483647",
"token_cryptogram": {
"pan_sequence_number": "011",
"type": "CONTACTLESS_CHIP",
"value": "jjoutwsdgfdou124354ljlsdhgout968957"
}
},
"sender_account_uri": "pan:5299926000000542;exp=2019-08",
"transaction_local_date_time": "2016-09-22T13:22:11-05:30",
"transfer_amount": {
"currency": "USD",
"value": "5300"
},
"transfer_reference": "TRNREF_20170815183830495"
}
}Response
Response details for a merchant transfer.
Example response
{
"merchant_transfer": {
"additional_message": "DEV123456",
"created": "2016-09-22T13:22:11-05:30",
"digital_account_reference_number": "pan:************1234",
"funding_source": "DEBIT",
"id": "mtrn_9abcd233jk23l6c5lw5f",
"interchange_rate_designator": "QR",
"mastercard_assigned_id": "111111",
"original_status": "APPROVED",
"participant": {
"card_acceptor_id": "CardAcceptor1",
"card_acceptor_name": "THE BEST BANK"
},
"participation_id": "TERMINAL34728",
"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_transfer",
"routing_transit_number": "965730000",
"sender": {
"additional_merchant_data": {
"sub_merchant_id": "A1234D"
},
"address": {
"city": "Chicago",
"country": "USA",
"country_subdivision": "IL",
"line1": "123 Elm St",
"line2": "Apartment 9",
"postal_code": "60618"
},
"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",
"convenience_amount": "10",
"convenience_indicator": "01",
"create_timestamp": "2016-09-22T13:22:11-05:30",
"funds_availability": "IMMEDIATE",
"id": "txn_8h4me233jk23l6c5lw5f",
"network": "MoneySend",
"network_status_code": "0",
"network_status_description": "APPROVED",
"payment_account_reference": "5001ESVM4JQAAOP5JKSK1XGAPOPG2",
"qr_data": "001006XX123400201012353611110030073041233004008LYL44354005009EEB",
"resource_type": "transaction",
"retrieval_reference": "624200192616",
"status": "APPROVED",
"status_reason": "APPROVED",
"status_timestamp": "2016-09-22T13:22:11-05:30",
"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": "TRANSFER123456"
}
}