IremboHub resolves fees from a ServicePricingDto attached to each service. The workflow triggers fee resolution when it reaches an EXECUTE_PRICING action; the system evaluates the pricing configuration against the submitted form data and presents the applicant with a payment bill.
| Field | Type | Required | Description |
|---|---|---|---|
paymentType |
"FREE" | "PAID" |
Yes | Whether the service collects payment |
pricing |
PricingDto | Paid only | How the fee amount is computed |
paymentCode |
PaymentFieldDto | Paid only | Bill/payment code sent to the gateway |
paymentAccount |
PaymentFieldDto | Paid only | Destination bank account |
paymentMerchant |
PaymentFieldDto | Paid only | Merchant identifier |
paymentExpirationHours |
number | Paid only | Hours until the payment bill expires |
Fields not applicable to the chosen paymentType must be null, not omitted.
Set paymentType: "FREE" and null every other field:
{
"paymentType": "FREE",
"pricing": null,
"paymentCode": null,
"paymentAccount": null,
"paymentMerchant": null,
"paymentExpirationHours": null
}
Set paymentType: "PAID". Below is a complete example using a fixed fee and a single payment account — the most common case:
{
"paymentType": "PAID",
"pricing": {
"priceType": "FIXED",
"baseValue": 20000,
"baseCurrency": "RWF",
"dynamicConditions": []
},
"paymentCode": {
"priceType": "FIXED",
"baseValue": "RRA-SERVICE-CODE",
"dynamicConditions": []
},
"paymentAccount": {
"priceType": "FIXED",
"baseValue": "GOR-CG-RWF",
"dynamicConditions": []
},
"paymentMerchant": {
"priceType": "FIXED",
"baseValue": "GOR",
"dynamicConditions": []
},
"paymentExpirationHours": 24
}
See Fee Calculation for dynamic and formula-based pricing strategies. See Payment Configuration for dynamic account routing and all payment field details.
Older pages kept in this wiki for this topic: