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: BANK or CARD. It should be based on the sender funding account type.
payer_id	long	Payer ID
payout_method	String	Payout method for transaction delivery. Enumerated Value: CASH_PICKUP or BANK_DEPOSIT or WALLET or HOME_DELIVERY.
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,INITIATED, DOCUMENT, PENDING, HOLD, PROCESSED, CANCELED, REFUNDED, RETURNED, FAILED
delivery_status	string	Delivery status of the transaction. Enumerated Value: PENDING, HOLD, DELIVERY_PAYOUT_READY, DELIVERY_FAILED, DELIVERY_REQUESTED, DELIVERED, DELIVERY_AUTHORIZED
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 UNVERIFIED, IN_PROGRESS, HOLD, VERIFIED, FAILED. Details below.
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 type=3ds to allow users to complete 3DS verification. Transaction will be in INITIATED status.
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.