Wallet Transfer Object

Transfer Object Details

Field	Required	Type	Description
amount	Yes	String	Amount to be transferred
fee_amount	No	String	Fee that Clients want to charge for a transfer
note	No	String	Note for amount transfer
currency	Yes	String	Currency of the amount. USD for all wallet transfers
from_fund_id	Conditional	String	ID of source funding account
type	Yes	Category	Enum: LOAD, UNLOAD and TRANSFER
to.id	Conditional	String	ID of receive user. This is only applicable for transfers of type TRANSFER
to.fund_id	Conditional	String	ID of receiving funding account
ip_address	Yes	String	IP of the user
status	Response	String	Enum value: INITIATED, PENDING, PROCESSING, PROCESSED, CANCELED, FAILED, HOLD and RETURNED

Wallet Transfer Status Reasons

Transfer	Reasons
Initiated	Transfer has been successfully created
Pending	Transfers have been forwarded for processing
Processing	Transfers are currently being processed
Processed	Transfers have been successfully credited into the receiving funding account
Failed	Transfer has failed. Please contact customer support
Hold	Transfer is on hold. Please contact customer support
Returned	Transfer has been returned. Please contact customer support

Hold Reasons in Transfer Response

Code	Message
T001	Transaction is under review by compliance. Machnet will provide further information once available.
T002	Issue processing transaction. Please contact Machnet customer support.
T003	Unable to check balance of the funding account. Please contact Machnet customer support.
T004	Transaction limit based on the current tier of the user has been exceeded. If the user is eligible to increase their limits, requested information must be submitted and verified for the transaction to be processed. Check requested information using this API.
T005	User verification is still in progress. All basic information must be submitted and verified for the transaction to be processed. Check KYC status using this API.
T006	Issue processing transaction. Please contact Machnet customer support.
T007	User is not verified. All basic information must be submitted and verified for the transaction to be processed.
T008	Issue processing transaction. Please contact Machnet customer support.
T009	Issue processing transaction. Please contact Machnet customer support.
T010	Possible duplicate transaction. Please review.
T011	Unable to process the transaction. ACH authorization form may be required from the receiver. Please contact Machnet customer support.
T012	Unable to process the transaction. ACH authorization form may be required from the receiver. Please contact Machnet customer support.
T013	User’s maximum wallet limit exceeded.
T014	Sender’s account is not verified. Please contact customer support for more details
TO15	Sender or sender’s account is not verified. Please contact customer support for more details
T016	Required sender information must be verified to process this transaction amount.

Cancel Reasons in Transfer Response

Code	Message
C001	Transaction risk is high
C002	Platform limit exceeded
C003	Transaction expired as it was on HOLD for more than 7 days
C004	Transaction was canceled by the user
C005	Transaction was canceled by the admin
C006	Transaction not authorized. Please contact Machnet customer support.
C007	Transaction not authorized. Please contact Machnet customer support.
C008	Transaction not authorized. Please contact Machnet customer support.
C009	Transaction not authorized. Please contact Machnet customer support.
C010	Transaction was canceled due to high risk of NSF.
C011	Transaction canceled as the user was suspended by admin.
C013	User’s maximum wallet limit exceeded.
C014	Receiver’s maximum wallet limit exceeded.
C015	Required recipient information must be verified to process this transaction amount.

We may add new Wallet Transfer Status, hold reasons and cancel reasons as and when required. The document will be updated accordingly.