Transaction Object
Details on transaction object
| Fields | Type | Description |
|---|---|---|
id | UUID | Transaction ID |
reference_number | string | Transaction reference number |
sender_id | UUID | Sender ID |
sender_funding_account_id | UUID | Sender Funding Account ID |
recipient_id | UUID | Recipient ID |
recipient_account_id | UUID | Recipient account ID. Recipient account can be recipient bank account or recipient wallet account. |
funding_source | String | Enumerated Value: |
payer_id | long | Payer ID |
payout_method | String | Payout method for transaction delivery. Enumerated Value: |
sender_amount | number | Amoung sent by the sender. |
fee_amount | number | Transaction fee to be charged to the sender |
exchange_rate | number | Exchange rate used for the transaction |
recipient_amount | number | Amount that is recipient receives |
recipient_currency | string | Currency for recipient amount |
remittance_purpose | string | Purpose of remittance |
calculation_mode | string | Enumerated value : SENDER_AMOUNT, RECEIVER_AMOUNT |
note | string | Note |
status | string | Status of the transaction. Enumerated Value: IN PROGRESS, |
delivery_status | string | Delivery status of the transaction. Enumerated Value: |
risk_score | number | Risk score of the transaction based on Machnet's assessment |
ip_address | string | IP address used to create the transaction |
remarks | string | Remarks |
receipt_number | string | Reference number of financial institution of the transaction |
payout_reference_number | string | Payout reference number for cash-pickup transaction. This may need to be provided to the recipient for cash pick up. |
transaction_status_history | list | List of change in status |
hold_reasons | list | List of transaction hold reasons |
bonus_amount | number | Bonus on the transaction. Refer to this for additional information. |
three_ds.enabled | Boolean | Represents if the card 3DS service is configured for the Client. This is only available for card transactions. If false, no further action is required. If true, further action may be required based on three_ds.status. |
three_ds.status | String | 3DS status of the card transaction. Enumerated value |
authorization_code | String | Authorization code received when a card transaction is approved or declined. This code is provided on the transaction invoice as well. |
Transaction hold reasons
| Code | Message | Description |
|---|---|---|
T001 | Sender Account is not Verified | Sender KYC is not verified. Transactions can only be processed for verified users. |
T002 | Service not supported in the location | Transaction was created using an IP outside of the permitted region. |
T003 | Transaction is under review | Transaction may be risky and is under review by compliance. |
T004 | Receiver account is not verified | Receiver’s account is not verified. Please contact customer support. |
T005 | Bank Credentials need to be updated by Sender | User’s bank credentials need to be updated. Please ask the user to re-login to their bank account. |
T007 | Unable to conduct balance check | Balance of the user’s funding source could not be checked. This increases chances of NSF. Please contact customer support. |
T008 | Transaction under review | Transaction is under compliance review. Please contact customer support. |
T009 | Unable to conduct compliance checks | Required compliance checks could not be conducted. Please contact customer support. |
T0010 | Unable to conduct compliance checks | Required compliance checks could not be conducted. Please contact customer support. |
T0011 | Connection issue | We are facing connection issues. Please contact customer support. |
T0012 | Connection issue | We are facing connection issues. Please contact customer support. |
T0013 | Connection issue | We are facing connection issues. Please contact customer support. |
T0014 | Connection issue | We are facing connection issues. Please contact customer support. |
T0015 | Connection issue | We are facing connection issues. Please contact customer support. |
T0016 | Connection issue | We are facing connection issues. Please contact customer support. |
T0017 | Sender under compliance review. | User is under compliance review. Please contact customer support. |
T0018 | Unable to conduct card verification. | Card verification of the user could not be completed. Please contact customer support. |
T0019 | Transaction under review by compliance. Please contact customer support for further information. | Transaction under review by compliance. Please contact customer support for further information. |
T0020 | Transaction under review by compliance. Please contact customer support for further information. | Transaction under review by compliance. Please contact customer support for further information. |
T0021 | Transaction under review by compliance. Please contact customer support for further information. | Transaction under review by compliance. Please contact customer support for further information. |
T0022 | Connection issue | We are facing connection issues. Please contact customer support. |
T0023 | Unable to conduct sanction screening. | Sanctions screening of the user could not be completed. Please contact customer support. |
T0024 | Card used to fund the transaction is duplicate with other users within the same affiliate. | Transaction is under review as card used to fund the transaction is duplicate with other users within the same affiliate. |
R001 | Transaction under review | Transaction is under compliance review. Please contact customer support. |
R002 | Transaction under review | Transaction is under compliance review. Please contact customer support. |
R003 | Transaction under review | Transaction is under compliance review. Please contact customer support. |
3DS Status Reasons
Status | Description | Action |
UNVERIFIED | 3DS has not been initiated for the transaction. | Open widget with |
IN_PROGRESS | 3DS verification is in progress | No action required. Transaction will be in INITIATED status. |
HOLD | 3DS verification is on HOLD as there was an error during the process. | Please review the transaction on the dashboard for further details or contact Machnet customer support. Transaction will be in HOLD status. Based on the error reason, admin can choose to unhold this transaction in which case 3DS verification will need to be completed again and 3ds_verification_required webhook is sent. |
VERIFIED | 3DS verification has been completed. | Transaction will be forwarded for further processing. |
FAILED | 3DS verification failed. | Transaction will be in CANCELED status. |
Last updated