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.
Delivery events
Delivery Status
Event
Description
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.

Funding account events

Event
Description
user_card_added
When the user’s card account has been successfully added.
user_card_removed
When the user’s card account has been successfully removed.
user_bank_added
When the user’s bank account has been successfully added.
user_bank_removed
When the user’s bank account has been successfully removed either through the widget or using API.
user_bank_verification_failed
When a user's bank account verification fails and it is locked. User cannot use this bank account to create a transaction.