Manage cross-border payments
Understand the post-initiation operations available for your cross-border payments. Learn how to retrieve transaction details and the appropriate actions to take based on the various status updates you receive.
The user in this document pertains to both the individual and business user types.
Use Cases
- You want to retrieve the list of cross-border payment transactions made by a specific user.
- You want to retrieve the details of a specific cross-border payment transaction.
- You want to know the appropriate handling of
failedandrejectedcross-border payments. - The customer wants to view all the cross-border payout transactions initiated from their accounts.
Prerequisites
- The user profile risk assessment status must not be
risk_flagged. - The user profile must be in an
activestatus. - The user must have an
approvedKYC or KYB status - The user account or wallet must be in an
activestatus. - The user's virtual account must be in an
activestatus. - At least one cross-border payout capability {
LOCAL, SWIFT} is enabled in your program. - At least one cross-border payment or remittance transaction has been initiated from the user (sender) account.
API Workflow
1
Retrieve all the remittance transactions made on an account
For audit and reporting purposes, or if you need to display all the transactions made on a specific account of a customer, we can:
Call Get All Transactions List (GET /users/wallets/payouts/remittances/transactions) to list down all the remittance transactions ever made on an account.
Get All Transactions List request
CURL
curl --location 'https://{{payouts_base_url}}/{{program_code}}/v2/users/wallets/payouts/remittances/transactions' \
--header 'X-Auth-User-ID: 3b1bec69292d41a5071e6ce747ba38d7' \
--header 'Authorization: Basic 'Get All Transactions List response
JSON
{
"pagination": {
"total_records": 26,
"records_per_page": 10,
"total_pages": 3,
"links": {
"self": "https://{{server}}/{{program_code}}/v2/users/wallets/payouts/remittances/transactions?page=1&records_per_page=10",
"next": "https://{{server}}/{{program_code}}/v2/users/wallets/payouts/remittances/transactions?page=2&records_per_page=10"
}
},
"data": [
{
"id": "KhDNPpVN0QDN5ADN0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "77030550348a45f79a612732efd50398",
"country": "VNM",
"currency": "VND",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "ASIA COMMERCIAL BANK",
"receiving_institution_code": "VNACVNVX",
"account_name": "asdasdasdas",
"account_number": "123123123",
"account_type": "Savings Account"
},
"quote": {
"id": "HllTGN0N0IDN5ADN0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "19028.583333333",
"details": {
"platform_rate": "19028.583333333",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "16.83"
},
"converted_amount": {
"currency": "SGD",
"amount": "12"
},
"recipient_amount": {
"currency": "VND",
"amount": "228343"
},
"additional_data": {
"purpose_of_payment": "Family Maintenance",
"user_occupation": "",
"user_recipient_relationship": "Father",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-04-08 06:40:43",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "162.158.192.147",
"tos_acceptance_user_agent": "okhttp/4.9.2",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-04-08T14:40:45 +08:00",
"updated_at": "2025-04-08T14:45:51 +08:00"
},
{
"id": "5I0VGBVO4UDM1YzM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "c3270ca26ac042b2875ea23cd0c789f5",
"country": "THA",
"currency": "THB",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "BANGKOK BANK PUBLIC COMPANY LIMITED",
"receiving_institution_code": "BKKBTHBKXXX",
"account_name": "Test",
"account_number": "123412341234",
"account_type": "Savings Account"
},
"quote": {
"id": "CVlMMpUO1IDM1YzM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "25.402000000",
"details": {
"platform_rate": "25.402000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "14.83"
},
"converted_amount": {
"currency": "SGD",
"amount": "10.00"
},
"recipient_amount": {
"currency": "THB",
"amount": "254.02"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Father",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-04-03 03:23:07",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "104.23.175.160",
"tos_acceptance_user_agent": "MaxiPay/5 CFNetwork/1568.300.101 Darwin/24.2.0",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-04-03T11:23:09 +08:00",
"updated_at": "2025-04-03T11:28:16 +08:00"
},
{
"id": "MdkM2cENxADM1YzM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "1a3b5b6e5b8e460eb8817c7b14fa2bd8",
"country": "THA",
"currency": "THB",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "AIA COMPANY LIMITED",
"receiving_institution_code": "AIACTHBK",
"account_name": "Hahhahga",
"account_number": "66777766611",
"account_type": "Savings Account"
},
"quote": {
"id": "FNVRSR1M5kTO0YzM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "25.402000000",
"details": {
"platform_rate": "25.402000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "14.83"
},
"converted_amount": {
"currency": "SGD",
"amount": "10.00"
},
"recipient_amount": {
"currency": "THB",
"amount": "254.02"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Mother",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-04-03 03:13:33",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "104.23.175.161",
"tos_acceptance_user_agent": "MaxiPay/5 CFNetwork/1568.300.101 Darwin/24.2.0",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-04-03T11:13:34 +08:00",
"updated_at": "2025-04-03T11:18:39 +08:00"
},
{
"id": "14kVUR0M0ATNzIzM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "1a3b5b6e5b8e460eb8817c7b14fa2bd8",
"country": "THA",
"currency": "THB",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "AIA COMPANY LIMITED",
"receiving_institution_code": "AIACTHBK",
"account_name": "Hahhahga",
"account_number": "66777766611",
"account_type": "Savings Account"
},
"quote": {
"id": "ERFOxEkMzATNzIzM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "25.038000000",
"details": {
"platform_rate": "25.038000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "19.83"
},
"converted_amount": {
"currency": "SGD",
"amount": "15.00"
},
"recipient_amount": {
"currency": "THB",
"amount": "375.57"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Mother",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-29 07:57:21",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "172.68.225.235",
"tos_acceptance_user_agent": "MaxiPay/5 CFNetwork/3826.400.120 Darwin/24.3.0",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-29T15:57:23 +08:00",
"updated_at": "2025-03-29T16:02:29 +08:00"
},
{
"id": "NVlR480NwcDM2EzM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "REJECTED",
"sub_status": "TRANSACTION_REJECTED",
"message": "Maximum cumulative transactions exceeded by recipient.",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "abbb9c16edd7485886e763e6ed2e1cc2",
"country": "IND",
"currency": "INR",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "AIRTEL PAYMENTS BANK LIMITED",
"receiving_institution_code": "AIRP0000001",
"account_name": "Bahjaha",
"account_number": "6161771",
"account_type": "Savings Account"
},
"quote": {
"id": "FVkUF10MwYDM2EzM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "63.327142857",
"details": {
"platform_rate": "63.327142857",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "17.45"
},
"converted_amount": {
"currency": "SGD",
"amount": "14.00"
},
"recipient_amount": {
"currency": "INR",
"amount": "886.58"
},
"additional_data": {
"purpose_of_payment": "Construction",
"user_occupation": "",
"user_recipient_relationship": "Mother",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-28 11:18:26",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "172.68.164.36",
"tos_acceptance_user_agent": "MaxiPay/5 CFNetwork/3826.400.120 Darwin/24.3.0",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-28T19:18:27 +08:00",
"updated_at": "2025-03-28T19:18:32 +08:00"
},
{
"id": "HZUVOFkMzcTO5gDM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "REJECTED",
"sub_status": "TRANSACTION_REJECTED",
"message": "Maximum cumulative transactions exceeded by recipient.",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "fbbd0cd8b8304e539f1a428ec2f7254e",
"country": "IND",
"currency": "INR",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "ABHYUDAYA COOPERATIVE BANK LIMITED",
"receiving_institution_code": "ABHY0065002",
"account_name": "LINDA",
"account_number": "123412341234",
"account_type": "Savings Account"
},
"quote": {
"id": "INUTQhUMxcTO5gDM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "64.478571429",
"details": {
"platform_rate": "64.478571429",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "17.45"
},
"converted_amount": {
"currency": "SGD",
"amount": "14.00"
},
"recipient_amount": {
"currency": "INR",
"amount": "902.70"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Daughter",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-02 07:15:30",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "162.158.192.152",
"tos_acceptance_user_agent": "okhttp/4.9.2",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-02T15:15:32 +08:00",
"updated_at": "2025-03-02T15:15:40 +08:00"
},
{
"id": "RR1VHp1N1MTO5gDM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful payment",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "715724569c634b72ac6805fe10a047e6",
"country": "MYS",
"currency": "MYR",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "MALAYAN BANKING BERHAD (MAYBANK)",
"receiving_institution_code": "MBBEMYKL",
"account_name": "charles ling",
"account_number": "123123",
"account_type": "Savings Account"
},
"quote": {
"id": "YhVOMZjNzMTO5gDM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "3.285714286",
"details": {
"platform_rate": "3.285714286",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "16.05"
},
"converted_amount": {
"currency": "SGD",
"amount": "12.60"
},
"recipient_amount": {
"currency": "MYR",
"amount": "41.40"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Father",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-02 07:09:16",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "162.158.192.152",
"tos_acceptance_user_agent": "okhttp/4.9.2",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-02T15:09:17 +08:00",
"updated_at": "2025-03-02T15:14:23 +08:00"
},
{
"id": "BB1SBNEN1ETO5gDM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful payment",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "715724569c634b72ac6805fe10a047e6",
"country": "MYS",
"currency": "MYR",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "MALAYAN BANKING BERHAD (MAYBANK)",
"receiving_institution_code": "MBBEMYKL",
"account_name": "charles ling",
"account_number": "123123",
"account_type": "Savings Account"
},
"quote": {
"id": "XtUWJZlM0ETO5gDM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "3.285833333",
"details": {
"platform_rate": "3.285833333",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "15.45"
},
"converted_amount": {
"currency": "SGD",
"amount": "12.00"
},
"recipient_amount": {
"currency": "MYR",
"amount": "39.43"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Father",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-02 07:05:52",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "162.158.192.152",
"tos_acceptance_user_agent": "okhttp/4.9.2",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-02T15:05:54 +08:00",
"updated_at": "2025-03-02T15:11:03 +08:00"
},
{
"id": "Ud1UERzMzATO5gDM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful payment",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "715724569c634b72ac6805fe10a047e6",
"country": "MYS",
"currency": "MYR",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "MALAYAN BANKING BERHAD (MAYBANK)",
"receiving_institution_code": "MBBEMYKL",
"account_name": "charles ling",
"account_number": "123123",
"account_type": "Savings Account"
},
"quote": {
"id": "Id0UwIjMyATO5gDM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "3.285000000",
"details": {
"platform_rate": "3.285000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "13.45"
},
"converted_amount": {
"currency": "SGD",
"amount": "10.00"
},
"recipient_amount": {
"currency": "MYR",
"amount": "32.85"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Father",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-02 07:03:52",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "162.158.192.153",
"tos_acceptance_user_agent": "okhttp/4.9.2",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-02T15:03:53 +08:00",
"updated_at": "2025-03-02T15:08:59 +08:00"
},
{
"id": "Sl1VWJFMxYDO5gDM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "PROCESSING",
"sub_status": "RECIPIENT_RISK_CLEAR",
"message": "Transaction is in progress as recipient risk is cleared",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "715724569c634b72ac6805fe10a047e6",
"country": "MYS",
"currency": "MYR",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "MALAYAN BANKING BERHAD (MAYBANK)",
"receiving_institution_code": "MBBEMYKL",
"account_name": "charles ling",
"account_number": "123123",
"account_type": "Savings Account"
},
"quote": {
"id": "UljRUJTO2QDO5gDM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "EXPIRED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "3.45"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "3.45"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "3.285833333",
"details": {
"platform_rate": "3.285833333",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "15.45"
},
"converted_amount": {
"currency": "SGD",
"amount": "12.00"
},
"recipient_amount": {
"currency": "MYR",
"amount": "39.43"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Father",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-03-02 06:56:49",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "162.158.192.152",
"tos_acceptance_user_agent": "okhttp/4.9.2",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-03-02T14:56:50 +08:00",
"updated_at": "2025-03-02T14:57:00 +08:00"
}
]
}2
Retrieve the details of a specific remittance transaction
Call Get Transaction Details (GET /users/wallets/payouts/remittances/transactions/{id}) to get all the details of a transaction, including the beneficiary details and the quotation details applied to the transaction.
Get Transaction Details request
CURL
curl --location 'https://{{payouts_base_url}}/{{program_code}}/v2/users/wallets/payouts/remittances/transactions/{{transaction_reference_id}}' \
--header 'X-Auth-User-ID: <user_id>' \
--header 'Authorization: : ••••••'Get Transaction Details response
JSON
{
"id": "MdkM2cENxADM1YzM0cTMtg0UDlEWNd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"user": {
"id": "3b1bec69292d41a5071e6ce747ba38d7",
"country": "SGP",
"currency": "SGD",
"type": "INDIVIDUAL"
},
"recipient": {
"id": "1a3b5b6e5b8e460eb8817c7b14fa2bd8",
"country": "THA",
"currency": "THB",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "AIA COMPANY LIMITED",
"receiving_institution_code": "AIACTHBK",
"account_name": "Hahhahga",
"account_number": "66777766611",
"account_type": "Savings Account"
},
"quote": {
"id": "FNVRSR1M5kTO0YzM0cTMtg0UDlEWNd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": false,
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "SGD",
"amount": "4.83"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "4.83"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
},
"total": {
"currency": "SGD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "SGD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "SGD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "25.402000000",
"details": {
"platform_rate": "25.402000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.100000000"
}
}
},
"charged_amount": {
"currency": "SGD",
"amount": "14.83"
},
"converted_amount": {
"currency": "SGD",
"amount": "10.00"
},
"recipient_amount": {
"currency": "THB",
"amount": "254.02"
},
"additional_data": {
"purpose_of_payment": "Advertising",
"user_occupation": "",
"user_recipient_relationship": "Mother",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "2025-04-03 03:13:33",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "104.23.175.161",
"tos_acceptance_user_agent": "MaxiPay/5 CFNetwork/1568.300.101 Darwin/24.2.0",
"tos_acceptance_service_agreement": "string"
},
"remarks": "I agree with terms of services.",
"created_by": "3b1bec69292d41a5071e6ce747ba38d7",
"created_at": "2025-04-03T11:13:34 +08:00",
"updated_at": "2025-04-03T11:18:39 +08:00"
}3
Handle remittance transaction status updates received from the webhook
Payout transactions are facilitated through a network of intermediary partners. Any participant in this chain can influence the transaction's fulfillment and can affect it.
When a transaction is actively rejected, its status is set to REJECTED, and a corresponding reason for the rejection will be populated in the sub_status field of the response payload.
Additionally, technical or operational issues experienced by any partner may result in a transaction failure, marked with the status FAILED. While MatchMove strives to ensure transaction fulfillment, certain failure scenarios are inevitable. The possible sub_status codes for failures are listed below.
To ensure end-user clarity, we recommend you display both the status and sub_status. This allows the user to understand the reason for failure and take the necessary corrective action to re-initiate the transaction successfully.
| The quote utilised is invalid. | The quote utilised for a transaction is invalid. Please create a new quote and try again. |
Transaction not permitted due to administrative or regulatory reasons | The transaction has failed due to regulatory reasons. Please contact support. | |
The transaction expired before the recipient took the necessary actions to receive funds | Please create a new quote and try again with a new transaction. | |
No routing option for the recipient URI provided | Please rectify the recipient's bank details and try again. | |
The card or issuer does not support receiving payments. | Please check with the recipient for the proper receiving institution details. | |
The sending amount is greater than the maximum allowed per transaction. | Please try with a smaller amount for a transaction. | |
The maximum cumulative transactions exceeded by the recipient. | The maximum number of transactions for a recipient has been exceeded. Please try again after some time. | |
The maximum cumulative amount exceeded by the recipient. | The cumulative amount received by a recipient has exceeded. Please try again after some time. | |
The maximum cumulative transactions exceeded by the receiving institution | The cumulative transaction count by a receiving institution has exceeded. Please try again after some time. | |
The maximum cumulative amount exceeded by the receiving institution | The cumulative amount received by a receiving institution has exceeded. Please try again after some time. | |
Invalid routing tag | Recipient's bank details are invalid. Please check the recipient's bank information. | |
The recipient account is not eligible to receive funds. | Recipient's bank details are invalid. Please check the recipient's bank information. | |
The recipient cannot receive funds due to an inactive account. | Recipient's account is inactive. Please check the recipient's bank details. | |
Recipient name does not match the account. | The recipient name doesn't match with the account name. Please check the recipient details. | |
The International Bank Account Number (IBAN) provided is invalid. | The IBAN used for the transaction is invalid. Please check the recipient bank details. | |
Incorrect IFSC or BIC code. | Recipient's bank details are incorrect. Please check the recipient details. | |
The recipient has not registered to receive payments. | Recipient has not registered to receive payments. Please check the recipient details. | |
Recipient is a minor, and RI does not support payments to minors. | Recipient is a minor and does not support payments to minors. Please check the recipient details. | |
The recipient address is suspected to be a bank address | Need to use the recipient's address instead of the bank's address. Please check the recipient details. | |
| Internal server error | The transaction failed due to some issues. Please retry after some time. |
The transaction timed out since the Receiving Institution did not respond | The receiving institution appears not to be responding. Please try again after some time. | |
Transaction cancelled via the system. | The transaction was cancelled due to internal reasons. Please contact support. | |
Payment routed correctly, unknown error provided by the Receiving provider. | The transaction failed at the receiving institution. Please contact support. |
Related Links
Was this section helpful?
On this page
- Manage cross-border payments