Quick Start

This guide walks you through integrating Embedded Finance into your system. Follow the steps in order to activate credit products and go live.

Prerequisites

Before starting integration:
  • Obtain API credentials from the WorldFirst developer portal
  • Configure your webhook endpoint URL in the developer portal
  • Determine which Embedded Finance products you want to integrate:
    • Revolving Loan (Credit Loan and/or Order Loan)
    • Factoring (Single-Transaction, Pool, and/or Quasi-Factoring)
    • VCC Credit Payment
    • Ecosystem Integration (AliExpress, Lazada, Tmall Global)

Step 1: Qualification & Onboarding

  1. Contact your Bettr regional representative to initiate credit qualification
  1. Provide business registration, transaction history, and platform flow data
  1. Bettr performs standardized credit assessment — no collateral required for most products
  1. Obtain API credentials and configure webhook endpoint URL in the developer portal

Step 2: Credit Line Activation

For Revolving Loan (Credit Loan)

POST /api/open/v1/creditLines/create
  1. Call
    creditLines.create
    to submit your credit line application with business data
  1. Subscribe to
    creditLines.*
    webhooks for approval status updates
  1. Upon
    creditLines.APPROVED
    , verify your credit limit via
    creditLines.query

For Revolving Loan (Order Loan)

POST /api/open/v1/orderLoans/create
  1. Call
    orderLoans.create
    with your confirmed order data and historical transaction records
  1. Subscribe to
    orderLoans.*
    webhooks for approval and disbursement updates

For Factoring

POST /api/open/v1/factoring/applications/create   (single transaction)
POST /api/open/v1/factoring/pool/create           (pool factoring)
  1. For single-transaction factoring, call
    factoringApplications.create
    with invoice details
  1. For pool factoring, call
    factoringPool.create
    to set up a pool facility, then
    factoringPool.addReceivables
    to add invoices
  1. Subscribe to
    factoringApplications.*
    or
    factoringPool.*
    webhooks

For VCC Credit Payment

POST /api/open/v1/vccCredit/create
  1. Call
    vccCredit.create
    — VCC application typically takes 3 minutes
  1. Subscribe to
    vccCredit.ISSUED
    webhook for card activation
  1. Once issued, the card is ready for payments

For Ecosystem Integration

POST /api/open/v1/ecosystem/bind
POST /api/open/v1/ecosystem/creditEligibility
  1. Call
    ecosystem.bind
    to link your e-commerce platform accounts (AliExpress, Lazada, Tmall Global) to WorldFirst
  1. Call
    ecosystem.creditEligibility
    to verify embedded credit eligibility on each platform

Step 3: Credit Operations

Revolving Loan — Draw and Repay

# Draw funds
POST /api/open/v1/creditDrawdowns/create

# Repay
POST /api/open/v1/creditRepayments/create

# Check repayment schedule
POST /api/open/v1/creditRepayments/querySchedule

Order Loan — Repay

POST /api/open/v1/orderLoans/repay

Factoring — Add Receivables and Monitor

# Add receivables to pool
POST /api/open/v1/factoring/pool/addReceivables

# Query pool status
POST /api/open/v1/factoring/pool/query

# Query single application status
POST /api/open/v1/factoring/applications/query

VCC Credit Payment — Use, Statement, Repay

# Use VCC card for payments → standard card payment flow

# Query monthly statement
POST /api/open/v1/vccCredit/queryStatement

# Repay outstanding balance
POST /api/open/v1/vccCredit/repay

# Adjust credit limit
POST /api/open/v1/vccCredit/manageLimit

Step 4: Repayment & Monitoring

  1. Monitor repayment schedules via
    creditRepayments.querySchedule
    and
    vccCredit.queryStatement
  1. Set up automated repayment from WorldFirst balance where applicable
  1. Subscribe to repayment webhooks for real-time status updates
  1. Track credit utilization and available balance across all active credit products

Step 5: Reconciliation & Compliance

  1. Use credit line statements and VCC billing statements for end-of-period reconciliation
  1. Match drawdown and repayment records against WorldFirst transaction history
  1. Maintain audit trail for compliance and regulatory reporting
  1. Generate reports via the
    reports.create
    API for credit-related transactions

API Reference Summary

Webhook Events Reference