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

Event	Description
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

Event	Description
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.