​
Pay Templates

Pay Templates let merchants choose the visual layout of their payment pages. Each template provides a distinct user experience optimized for different use cases.

​
Available Templates

IDNameBest For
AStacked Card FlowMicro-payments, B2C mobile
BSingle Pane PremiumStandard shops, average basket (default)
CSplit Layout TrustB2B premium, large amounts

​
Setting the Default Template

Merchants set their default pay template from Settings > White Label > Pay Template section.

​
API

PATCH /api/v1/me/white-label/branding
Content-Type: application/json

{
  "defaultPayTemplateId": "A"
}
Accepted values: "A", "B", "C". Each payment link can override the organization default: 
POST /api/v1/payments/payment-links
Content-Type: application/json

{
  "name": "Premium subscription",
  "amount": 5000,
  "currency": "XAF",
  "templateId": "C"
}
If templateId is omitted, the organization’s defaultPayTemplateId is used. If neither is set, template B (Single Pane Premium) is the platform default.

​
Preview

Preview any template at: 
/pay/preview/A
/pay/preview/B
/pay/preview/C

​
Resolution Logic

The frontend resolves the template to display using this priority:
  1. paymentLink.templateId — per-link override
  2. merchantDefaultPayTemplateId — organization default
  3. B — platform default