​
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
DPlatform NativeMerchants who want a checkout aligned with their Simiz back-office
ESplit Brand ShowcaseMerchants with a strong visual identity, premium e-commerce
FSplit Warm AccentModern shops, lifestyle brands, recurring payments

​
Setting the Default Template

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

​
API

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

{
  "defaultPayTemplateId": "A"
}
Accepted values: "A", "B", "C", "D", "E", "F". Each payment link can override the organization default: 
POST /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
/pay/preview/D
/pay/preview/E
/pay/preview/F

​
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