How To: Implement SEPA / UK Faster Payments
Developers can use the following guide to learn how to use our apis to implement SEPA & UK Faster Payments.
Overview
Developers can use the following guide to learn how to use our apis to implement SEPA & UK Faster Payments.
Implementation
UI Implementation (Option 1)
- Generate a Checkout Link
This endpoint will generate a url which can be added to an iframe.RequestResponse - Place the webpage in an iframe
Below is an example of how you can put the returned checkout link in an iframe and display Coinflow’s checkout modal to the end user. To quickly test a proof of concept, you may add the url here.
UI Implementation (Option 2)
Coinflow provides SDKs for react, vue, angular, and react native. You can easily integrate our components into your application by following the steps below.
API Implementation
-
Create a session key
This endpoint returns a JWT that is unique to the customer. When calling this endpoint, thex-coinflow-auth-user-idcan be any unique customer identifier string that you, the Merchant, uses to identify the buyer.RequestResponse -
Get Totals
This endpoint will allow you to show total purchase price after all fees.Request - UKResponse - UKRequest - SEPAResponse - SEPA -
Complete a new SEPA/UK Faster Payment
This endpoint should be utilized by new customers who has never completed a payment or does not have a tokenized IBAN. This endpoint will tokenize their IBAN details, create the customer record, and return payment details which the customer will need to complete the purchase from their banking app.📘 The presentment currency is specific to the chosen payment method.
For example, prices are displayed in GBP if the payment method is UK Faster Payments, and euros for SEPA transfers.
If you pass
subtotals.currency = GBPfor a SEPA transfer or , you will get an currency is not supported for payment method error.Request - UKResponse - UKRequest - SEPAResponse - SEPADisplay the response details to the customer and prompt them to complete the payment by going on their banking app and send the amount to the provided account (include the IBAN account number and/or the sort code).
When the customer has confirmed the payment from their banking app, Merchants will see the payment record status has been updated.
❗️ The payment intent record is valid for 5 minutes.
If the customer has not completed the payment within 5 minutes, the payment status will be marked as
expired. -
Get Customer to retrieve a tokenized IBAN
This endpoint gets all details associated with the customer, including any of their previously used payment methods.Request - UKResponse - UKRequest - SEPAResponse - SEPA -
Complete a SEPA/UK Faster Payment with a saved IBAN
This endpoint should be utilized by existing customers who already have a tokenized IBAN. This endpoint will only return payment details which the customer will need to complete the purchase from their banking app.📘 The presentment currency is specific to the chosen payment method.
For example, prices are displayed in GBP if the payment method is UK Faster Payments, and euros for SEPA transfers.
If you pass
subtotals.currency = GBPfor a SEPA transfer or , you will get an currency is not supported for payment method error.Request - UKResponse - UKRequest - SEPAResponse - SEPADisplay the response details to the customer and prompt them to complete the payment by going on their banking app and send the amount to the provided account (include the IBAN account number and/or the sort code).
When the customer has confirmed the payment from their banking app, Merchants will see the payment record status has been updated.
❗️ The payment intent record is valid for 5 minutes.
If the customer has not completed the payment within 5 minutes, the payment status will be marked as
expired.

