New Checkout

post https://api.finmo.net/v1/checkout

Checkout creates a secure, Finmo-hosted payment page that lets you collect payments via local payment methods such as Bank transfers, Cards, Direct Debit & Wallets as quickly as you can. It works across devices and can help increase your conversion.

Checkout makes it easy to build an optimal payments experience:

Designed to remove friction
Mobile-ready
Support multiple payment methods globally
White Label - Add your logo, support details and customize the payment instructions by Payin method.
Customisable buttons and background color

Following are some considerations to be able to optimize the checkout experience for the consumer:

Step 1 : Decide how much time you want to give to the customer to pay you and set an expiration date-time. Typically if the Payin method supports expiration, it will also have the same date-time. For e.g. PayID in Australia usually expires in 24 hours.
Step 2 : Decide if you want to only provide specific Payin method to the consumer to pay or the entire set or just a category. It can be achieved through include & exclude options. Category is basically type of Payin method like Bank, E-Wallet, Card etc.
Step 3 : Decide how you want the Checkout completion to work, i.e., will the user be redirected to one URL or multiple. We have a field REDIRECT_URL which is a common URL to redirect the consumer to. You would need to handle the status message based on the parameters we provide you in the REDIRECT_URL. The other option is you pass 4 different or same URL under the ADVANCED_REDIRECT_URL, this way you can show the right status message based on the events happened on the checkout page.
Step 4 : Decide if you want to notify someone of this checkout link via email or sms. Finmo will send the link to them to pay the invoice via the checkout link.

Checkout Status & Webhook Notifications
Finmo will notify you of the status change of Checkout object via webhooks. You can always choose to configure a static webhook listener URL via the dashboard or you can send a dynamic webhook URL in the Create Checkout request.

When you create a Checkout page, Finmo will trigger a CHECKOUT_CREATED webhook. Checkout status would be CREATED.
Once the consumer selects the Payin method on the Checkout page and submits, Finmo will trigger a PAYIN_CREATED webhook which will have the CHECKOUT_ID as well so you know who to relate this Payment to. Checkout status at this stage will still be CREATED but the Payin status would be PENDING.
Once the consumer makes the Payment, Finmo will trigger two webhooks CHECKOUT_COMPLETED and PAYIN_COMPLETED respectively. Both Checkout and Payin status will change to COMPLETED.
In case, the Checkout page expires, Finmo will trigger a CHECKOUT_EXPIRED webhook as well as PAYIN_EXPIRED webhook. Both Checkout and Payin status will change to EXPIRED.
In case the consumer decides to hit cancel button on the Checkout page, Finmo will trigger a CHECKOUT_CANCELLED webhook and if Payin method is_cancelable = true then we will cancel the Payment too. Both Checkout and Payin status will change to CANCELLED.

Create Checkout page
Use the POST method to create a checkout page that makes a payin. This method can be used by you without the need for PCI certification.