Events
Read on when webhooks are sent from our system
KYC events
KYC Status
Events
Description
Occurance
IN_PROGRESS
user_kyc_in_progress
User's KYC is in progress.
Queued for running KYC after ‘initiate KYC’ API is called
VERIFIED
user_kyc_verified
User’s KYC is complete and user details are verified.
User KYC is successfully complete.
RETRY
user_kyc_retry
If user KYC is not complete and additional details have to be provided. Once the details have been collected, ‘Initiate KYC’ API needs to be called again.
After the ‘initiate KYC’ API is called and user status is not VERIFIED.
SUSPENDED
user_kyc_suspended
When a user's KYC is rejected during KYC process.
REVIEW_PENDING
user_kyc_review_pending
When a user’s KYC process is in review state.
Transaction events
Transaction Status
Event
Description
INITIATED
No Webhook
The transaction request has been submitted in our system.
PENDING
transaction_created
The transaction is undergoing compliance check or has been selected for processing.
PROCESSING
transaction_processing
The transaction is being processed.
PROCESSED
transaction_processed
The transaction has been processed successfully.
FAILED
transaction_failed
The transaction was unable to be processed.
HOLD
transaction_onhold
When the user’s transaction is on hold. The hold reason is provided in the response when fetching transaction information.
CANCELED
transaction_canceled
The transaction was cancelled by the user or admin.
RETURNED
transaction_returned
Transaction has been returned.
REFUNDED
transaction_refunded
Transaction has been successfully refunded to the sender.
Delivery events
Delivery Status
Event
Description
NONE
No webhook
Initial status. Transaction delivery has not been requested or transaction has not been forwarded for delivery.
PENDING
transaction_delivery_pending
Transaction has been forwarded for delivery.
DELIVERY_REQUESTED
transaction_delivery_requested
Client has requested delivery of the transaction.
HOLD
transaction_delivery_onhold
Delivery of transaction has been placed on hold.
DELIVERY_FAILED
transaction_delivery_failed
Transaction could not be delivered.
DELIVERY_PAYOUT_READY
transaction_delivery_payout_ready
Only relevant for cash pick up transactions. Recipients can go pick up cash from the designated location when it is delivery payout ready.
DELIVERED
transaction_delivered
Transaction has been successfully delivered/paid out to the recipient.
DELIVERY_AUTHORIZED
transaction_delivery_authorized
Transaction delivery is authorized. If you are paying out transactions yourself as per agreement with Machnet, you can now proceed to delivery the transaction to the recipient.
DELIVERY_CANCELED
transaction_delivery_canceled
When transaction is cancelled, transaction delivery is automatically cancelled too.
Funding account events
Event
Description
user_card_added
User’s card account has been successfully added.
user_card_removed
User’s card account has been successfully removed.
user_bank_verification_pending
User’s bank account has been added but verification status is “PENDING”. User can create a transaction using the funding account but it will not be processed until the account is verified.
user_bank_added
User’s bank account has been successfully added and the account has been verified.
user_bank_removed
User’s bank account has been successfully removed either through the widget or using API.
user_bank_verification_failed
User's bank account verification failed and it is locked. User cannot use this bank account to create a transaction.
bank_login_required
User needs to re-login to their account. You will have to open the bank widget again with the particular funding account ID and ask user to login to their bank again.
Widget events
BANK_ERROR
Error while adding bank using widget. Please try again.
CARD_ERROR
Error while adding card using widget. Please try again.
BANK_ADDED
Bank successfully added but account verification may be pending.
CIP tag status events
cip_tag_submitted
User information has been successfully submitted.
cip_tag_reviewing
User information is under review. The status of this CIP tag will be updated once review is completed.
cip_tag_verified
User information has been successfully verified
cip_tag_failed
User information verification has failed
cip_tag_requested
User information has been requested. Please ask the user to submit this information.
Last updated