BizuraBizuraKnowledge Base
Русский
Knowledge Base/Payments/How to build a custom payments integration on the platform

How to build a custom payments integration on the platform

This guide walks you through building a

Last updated: May 26, 2026

Was this article helpful?

On this page

  • 1. Overview
  • 2. Key Concepts
  • 3. Prerequisites
  • 4. High-Level Integration Flow
  • 5. Step 1 – Create Your Marketplace App
  • 5.1 Access Marketplace Dashboard
  • 5.2 Settings Configuration
  • 5.2.1 Required scopes
  • 5.2.2 Redirect URL
  • 5.2.3 Client Keys
  • 5.2.4 Webhook URL (App install/uninstall)
  • 5.2.5 SSO Key
  • 5.3 Payment Provider Configuration
  • 5.4 Profile
  • 5.5 Custom Pages
  • 6. Step 2 – Implement Authentication & Installation Flow
  • 6.1 Installation sequence
  • 6.2 Create Public Provider Config
  • 7. Step 3 – Connect Test & Live Configuration
  • 8. Step 4 – Implement the Checkout iFrame Integration
  • 8.1 Ready Event: custom_provider_ready
  • 8.2 Payment Initiation Event: payment_initiate_props
  • 8.3 Outcome Events
  • 8.3.1 Payment succeeded
  • 8.3.2 Payment failed
  • 8.3.3 Payment canceled
  • 8.4 Verification Call: type: "verify"
  • 9. Step 5 – Saved Payment Methods & Manual Subscriptions
  • 9.1 Add Payment Method (Card on File)
  • 9.2 List Payment Methods – type: "list_payment_methods"
  • 9.3 Charge Payment Method – type: "charge_payment"
  • 9.4 Manual Subscriptions (Subscription Schedules) with Saved Methods
  • 9.4.1 Declare your capability
  • 9.4.2 Runtime flow: type: "create_subscription"
  • 9.4.3 Runtime flow: type: "cancel_subscription"
  • 9.4.3 Cancel subscription: type: "cancel_subscription"
  • 10. Step 6 – Refunds & Other Actions
  • 10.1 Refund Event – type: "refund"
  • 11. Step 7 – Webhooks from Bizura
  • 11.1 Webhook Endpoint
  • 11.2 Supported Events
  • 11.3 General Payload Structure
  • 11.4 Mandatory Fields by Event
  • 11.5 subscriptionSnapshot Schema
  • 11.6 chargeSnapshot Schema
  • 13. Frequently Asked Questions

In this folder

  • How-to add Taxes Overview
  • Using Apple Pay and Google Pay in order forms
  • Customize Email and SMS notifications for invoicing
  • How to manage Refunds within the CRM?
  • How to Manage Sales Receipts for Order Form, Calendar and Invoice payments
  • Selling products on order forms with available payment providers
  • How to Send Confirmations After a Purchase/Order
  • List of countries and bank acquirers available with NMI
  • Manage payment methods displayed with Stripe integration
  • How to Streamline Payments with Automated Invoice Reminders
  • How to Add Recurring Products to Your Products List in Documents and Contracts
  • How to Implement Direct Checkout in Email Campaigns
  • How to Use the Manual Payment Method in Your Ecommerce Store
  • How to Use BNPL in Order Forms and Payment Links
  • How to Enable Editable Quantities in Payment Links
  • Multiple recipient support on Proposals and Estimates
  • Tax Inclusive or Exclusive Pricing
  • VAT FAQs
  • How to add and manage your customer's cards on file
  • What happens in case of a payment failure for a Subscription?
  • Tap to Pay
  • Automatic Taxes on Mobile
  • Invoices - New revamped UI
  • Bank-Only Transfers for Invoice Payments (SEPA & ACH)
  • How to Edit Recurring Invoices
  • How to View Invoices and Download Receipts in the Mobile App
  • Setting up QuickBooks Integration
  • Editing of Payment Schedules and Partially Paid Invoices
  • PDF Generation for Invoices and Receipts
  • Import Invoices Using CSV

© 2026 Bizura. All rights reserved.

Powered by Bizura Knowledge Base