New Customer

Create customer profile to save the payment methods a customer can use, facilitating recurring transactions and track their payment history. A customer object is beneficial to store a card token for subscriptions or create a Finmo customer wallet to manage their funds.

To issue a Customer Wallet or Virtual Account(VA), Finmo is required to collect additional information to meet regulatory requirements for account creation. You must provide all mandatory fields to enable these capabilities. Use the Get Customer Fields API to retrieve the complete list of required fields.

Customer creation journey: When a customer is created with all mandatory fields, their status is set to UNDER_REVIEW by default. If any mandatory fields are missing, the status will be PENDING_INFO. After review, the customer will be assigned one of the two final statuses: APPROVED or SUSPENDED.

Status Flag - distinct values & meanings:

1. PENDING_INFO: Customers can be created in a PENDING_INFO state by providing a minimal set of fields intended for non-transactional use-cases such as Accounts Receivable (AR). Following minimal details are required to create a customer: [Customer Type: Company: name; Individual: first_name, last_name]
2. UNDER_REVIEW: Only when all mandatory customer fields are provided, UNDER_REVIEW customer status is observed intermittently. Mandatory fields for creating a transactional customer can be retrieved via Get Customer Fields API.
3. APPROVED: Allowed to create customer wallets, VAs and send/receive funds corresponding to a customer.
4. SUSPENDED: Only non-transactional use case-cases such as AR are allowed.

Note:

1. We recommend integrating the Get Customer Fields API into your customer creation or update workflow to fetch the mandatory fields and pass the required values in the Create Customer API or Update Customer API, as applicable.
2. This ensures that the customer moves to the UNDER_REVIEW state and, upon approval, can be used to create Customer Wallets or Virtual Accounts and to send or receive funds for that customer.
3. Please ensure that all required mandatory documents are uploaded before creating a customer. You can refer to the Document Upload API. for more information.