Skip to main content

33 docs tagged with "Embedded model"

View all tags

Approve and reject payouts

In case you want to integrate an additional layer of security to your payments, you can approve or reject payouts before they go out. For example, your customers may create a payout request, and your Ops team should verify and approve it. With the approval flows enabled, a payout will go to a pending state after the wallet details are provided. Then BVNK will wait for an Approve or a Reject call to proceed or cancel the payout.

Business requirements

To onboard a business Enterprise Payment customer onto our platform, we must collect and verify essential information regarding the business and its ownership. This is a regulatory requirement and a critical component of our risk management process.

Collect via Channels

Use channels to add crypto payments to your checkout flow. In this guide, you'll use the BVNK-hosted page—though you can build your own UI using the API responses. Next, we'll outline the channels workflow so you understand how to implement it yourself if you decide not to use the hosted page.

Convert funds (on-ramp)

An on-ramp is the process of automatically converting value from fiat currency into crypto, offering customers greater financial flexibility by providing them direct access to crypto from fiat payments without multiple manual steps.

Create a customer

The following guide describes how you can create company or individual customer accounts on the BVNK platform.

Enable payouts for customers

The customer stablecoin payment flow enables Payment Service Providers (PSPs) to offer stablecoin payouts to their customers without requiring direct integration with cryptocurrency infrastructure.

Exception scenarios

The final step is to build in handling for exceptions that may occur in the payment flow. The types of webhooks are covered on the Receive Payment Notifications page, but the following guides provide a more detailed explanation of the scenarios.

Find your use case

Use this table to quickly identify which BVNK use case matches your business needs. Compare use cases to understand the target industries, currency flows, required delivery models, and available product features. Click the use case link to view detailed implementation guides, or use the Model links to learn more about the delivery models (Direct or Embedded) that support each use case.

Gather compliance data for onboarding

To complete the onboarding of new customers, you must provide their details for the KYC/KYB checks. To collect the information, Questionnaires with industry-related questions are used.

Individual requirements

To successfully onboard consumers or individual customers to the BVNK platform, the following information is required:

Industry references

This is a definitive list of industries and sub-industries which can be included in the payload when creating a customer.

Late Payments

This type of payment is specific for Merchant Payment Services / Payment Links only.

Monthly expected volumes

This is a definitive list of Expected Monthly Volume values which can be included in the payload when creating a customer.

Overpayments

Overpayments occur when end-users send more cryptocurrency than intended. For example, they intend to send 0.01 ETH but send 0.1 ETH instead. In this case, the payment still transitions to a COMPLETE status.

Prepare customer agreements

Before creating customer accounts via API, ensure your customers have accepted and signed BVNK's Terms and Conditions.

Receive fiat funds via SWIFT

To receive fiat funds in your BVNK virtual account, you can deposit EUR, GBP, or USD from a registered bank account. This guide explains how SWIFT wallets work and how to obtain the deposit details your senders need.

Receive stablecoin payments

Using BVNKs Receive products, you can collect crypto payments from your customers, allowing them to top up accounts or purchase goods and services from you whilst BVNK manages the conversion and settlement to your accounts.

Receive stablecoins via Payment Links

Use this method to add crypto payments to your checkout flow and collect payments from your customers. You have the option to build your own UI using the API response or redirect your user to a pre-built Hosted Payments Page.

Refund Payments

In the case where a payment exception scenario has taken place, BVNK provides the option to automatically refund the cryptocurrency for merchants who do not want to hold these cryptocurrencies, due to any compliance issues, or for merchants that do not want to internally process any payments that have fallen outside of the agreed upon payment rules.

Reliance Onboarding

Please treat this article with caution—it's here to demonstrate a flow that's currently being developed. Endpoint and field names might change or be removed as things evolve.

Retrieve customer details

With these endpoints, you can retrieve information about a specific customer within the system: key customer data, including their profile, associated wallets, and other relevant details. You can list all customers or acquire details of a specific one.

Send stablecoin payments

The following guide describes how you can integrate stablecoin payments into your platform via BVNK.

Underpayments

Underpayments occur when end-users do not transfer enough cryptocurrency to fulfill their payment obligation.

Update customer details

With these endpoints, you can update information about a specific customer within the system: key customer data, including their profile, associated wallets, and other relevant details. You can update the customer's profile, address, and other relevant details.