¶ In this lesson you will
- Know what each identifier does
- Choose fixed or dynamic routing
- Configure a district-based account
¶ Where the money goes
Every bill carries three identifiers, provided by the organization's finance team and IremboPay:
- Payment Account Identifier: the bank account that receives the money (it also fixes the currency), e.g.
TST-RWF. - Service Payment Code Identifier: what is being paid for, used for reporting, e.g.
PI-3e5fe23f2d. - Payment Merchant: the organization collecting the money, e.g.
GOR. Always a single fixed value.
The demo service uses the account GOR-CG-RWF and the merchant GOR (lesson A7).
Fixed routing: one account, one code, one merchant
- Fixed or Dynamic
- Account: TST-RWF
- Service payment code
- Merchant: always a single value
Dynamic account: one scenario per case
- Dynamic selected
- The account for this scenario (USD here)
- When Service Level = Basic
-
- Add Scenario
Fixed vs dynamic routing
| Service | Account | Code | Merchant |
|---|---|---|---|
| Kigali information request (handled centrally) | Fixed: KIGALI_MAIN-RWF |
Fixed: INFO_REQUEST |
Fixed |
| District cleaning fee (money goes to the district) | Dynamic: GASABO-RWF / KICUKIRO-RWF / NYARUGENGE-RWF by processingDistrict | Fixed: CLEANING_FEE |
Fixed |
Gotcha · the currency of the account must match the price
A USD price billed on an RWF account, or the reverse, fails at payment. When a scenario changes the currency, route it to an account of that currency, as in the screenshot above.
¶ Check yourself
Building permits are processed and paid to the district chosen in the form (Gasabo, Kicukiro, Nyarugenge). All permits share one service code and Kigali City is the merchant. Which configuration?
- A. Fixed account, fixed code, fixed merchant
- B. Dynamic account, fixed code, fixed merchant
- C. Fixed account, dynamic code, fixed merchant
- D. Dynamic account, dynamic code, fixed merchant
Show the answer
B. Only the destination account changes with the district: one scenario per district. The service is the same (fixed code) and the merchant is always fixed.
← B5 · Price Logic: a central pricing rule · B7 · Workflow actions →