4N-JM-001BANKING· Current · Banking and payments
Bank OTP by SMS in Jamaica: BOJ rules and JAM-DEX wallets
Banks and payment providers in Jamaica are supervised by the Bank of Jamaica, which also issues JAM-DEX, the digital Jamaican dollar used through mobile wallets such as Lynk. When a customer logs in or approves a payment, your banking system creates a one-time code and calls the 4notify REST API to deliver it.
SMSEmailPush
One-time codes protect online banking and wallet payments against fraud, and the Bank of Jamaica expects licensees to manage that risk. A code that arrives late or not at all also turns into a call to your contact centre, so the delivery route matters as much as the code.
SMS reaches subscribers of Digicel and Flow, Jamaica's two mobile networks, on +1 876 and +1 658 numbers.
Laws and rules referred to
- Banking Services Act, 2014The framework under which the Bank of Jamaica licenses and supervises deposit-taking institutions, including their operational risk.
- Payment Clearing and Settlement Act, 2010Gives the Bank of Jamaica oversight of payment systems and payment service providers.
- Bank of Jamaica Act (as amended for JAM-DEX)The legal basis for the central bank digital currency issued by the Bank of Jamaica.
How it works
- 1Your system creates the codeYour banking or wallet platform generates the one-time code and decides how long it stays valid. 4notify does not generate, store or check codes.
- 2One API call sends the SMSYour system calls POST /api/v1/sms with the customer's number and the text. The SMS leaves through the 4notify relay or your own provider, with automatic switching between your configured SMS routes.
- 3Email or in-app push as a second channelYour system can send the same code by email, or by push inside your own banking app, through the same API.
- 4Delivery status per messageEvery message shows its delivery status in the dashboard and API, so your support team can see whether a code left and was delivered.
API request
POST /api/v1/sms
Authorization: Bearer <JWT>
{
"to": "+18765550142",
"text": "NCB: your code to approve a J$45,000 transfer is 618204. Valid 5 minutes. Never share this code."
}Sample message
SMS
NCB: your code to approve a J$45,000 transfer is 618204. Valid 5 minutes. Never share this code. We will never call to ask for it.
Compliance checklist
- ✓Code generation and checking stay inside your own banking system
- ✓SMS route chosen: 4notify relay or your own provider, with a back-up route configured
- ✓Delivery tested to Digicel and Flow numbers
- ✓Delivery status of each code reviewed in the dashboard or API
Why 4notify
One REST API for codes and payment alerts, SMS to Digicel and Flow with automatic switching between your SMS routes, and the delivery status of every message in one dashboard.
Frequently asked questions
Does 4notify verify the code or the customer?
No. Your system creates and checks the code. 4notify delivers the message and reports its delivery status.
Can 4notify send JAM-DEX payment confirmations?
Yes, if your wallet or banking system calls the 4notify API with the confirmation text. There is no direct connection to Lynk or to the Bank of Jamaica.