Back to Project
Merchant Onboarding
Promoter NSA · QorCommerce Boarding · Underwriting
Merchant Onboarding
Promoter NSA · QorCommerce Sub-Merchant Boarding · Underwriting · Status Sync
1 · PROFILE CAPTURE
Promoter or club operator completes onboarding wizard
Legal name · DBA · EIN · DOB · address · principals · banking · KYC docs
2 · NSA PDF GENERATION (PROMOTER FLOW)
generate-promoter-nsa-pdf
Edge Function (Deno)
pdf-lib stamps template
Stamped fields
Name · EIN · Signature image
ISO timestamp · IP audit
Supabase Storage
Signed PDF written
Linked to promoter profile
3 · QORCOMMERCE SUB-MERCHANT BOARDING
board-merchant
For clubs
POST /merchants (PFaaS)
board-promoter
For promoters
Shared qor-helpers · TDD
Provider IDs stored
merchant_id · status=pending
boarded_at timestamp
4 · UNDERWRITING DOC UPLOAD · STATIC-IP RELAY
upload-underwriting-docs
Edge Function
Stores PDF/JPG in Storage
Validates KYB document type
transmit-merchant-docs
Posts to relay
Feature-flag gated
QORPAY_DOC_UPLOAD_ENABLED
Render Relay (Node)
Static outbound IP
Multipart → PFaaS
Satisfies IP allowlist
5 · STATUS RECONCILIATION
payment-webhook
merchant.verified
merchant.declined
→ updateMerchantBoardingStatus
poll-merchant-status
On-demand fallback
If webhook missed
Admin trigger
Status → active
Live charges enabled
Payouts enabled
Operator notified
TDD-tested · idempotent · bypass mode for App Store review accounts