Master / reference APIs
Master APIs supply the coded values the transactional APIs expect — remittance purpose, source of funds, relationship, occupation, bank lists and more. Fetch the master and reference values required by the selected transaction type, route and payout payload; there is no requirement to call them all. In the integration sequence they sit between the customer-registration decision and the payout request, alongside the Bank List, which supplies the beneficiary bank information a payout route requires.
Published master APIs
These 14 master APIs are documented and published in the RHUB source.
| Master API | Method | Endpoint | Reference |
|---|---|---|---|
| Remittance Purpose | GET | http://host/ewallet/api/v1/purposeOfRemittance/RHUB/{transactionType}/{countryCode} | Open |
| Source of Fund | GET | http://host/ewallet/api/v1/getSourceOfFund/RHUB/{transactionType}/{countryCode} | Open |
| Relationship | GET | http://host/ewallet/api/v1/getRelationship/RHUB/{transactionType} | Open |
| Document ID Type | GET | http://host/ewallet/api/v1/getDocumentIdType/RHUB/{transactionType} | Open |
| Occupation | GET | http://host/ewallet/api/v1/getOccupation/RHUB/{transactionType} | Open |
| Business Type | GET | http://host/ewallet/api/v1/masterBusinessTypes/RHUB/{transactionType} | Open |
| Business Registration Type | GET | http://host/ewallet/api/v1/masterBusinessRegistrationTypes/RHUB/{transactionType} | Open |
| Account Type | GET | http://host/ewallet/api/v1/accountType/all | Open |
| WPT Wallet List | GET | http://host/ewallet/api/v1/walletList/{countryCode}/{currencyCode}/{receiverCode}/WPT | Open |
| Bank List | GET | http://host/ewallet/api/v1/payoutbanklist/{country}/{currency}/{recieverCode} | Open |
| Customer Legal Status | GET | http://host/ewallet/api/v1/customerLegalStatus/getByCustomerTypeCode/{customerTypeCode} | Open |
| Nature of Business | GET | http://host/ewallet/api/v1/natureOfBusiness/getByCustomerTypeCode/{customerTypeCode} | Open |
| Customer Occupation Type | GET | http://host/ewallet/api/v1/customerOccupationType/getByCustomerTypeCode/{customerTypeCode} | Open |
| Customer/Individual Document Type | GET | http://host/ewallet/api/v1/customerDocumentType/getByCustomerTypeCode/{customerTypeCode} | Open |
RHUB defines ten further master categories that it does not publish: Legal Status Code, Payment Mode, Branch List, Customer Type, Resident Status, Purpose of Opening Business, Transaction Volume, ID Type, Customer Document Fetch and Payout Validator. They are not documented here — confirm with RHUB before relying on any of them.