Send a notification to a customer
Send a notification to a customer through one of the supported channels - SMS, EMAIL, or PUSH notification.
The templateId identifies a pre-configured notification template. The params object provides dynamic values to be substituted into the template placeholders.
Templates and their available parameters are configured by M2P during onboarding. Contact M2P to get the list of available template IDs and their required parameters.
Authorization
BearerAuth TenantHeader JWT Bearer token obtained from the /auth/login endpoint
In: header
Tenant identifier provided by M2P (e.g. ENBDTABBY)
In: header
Request Body
application/json
Kit number of the customer to notify
Notification delivery channel. SMS for text message, EMAIL for email, PUSH for push notification.
"SMS" | "EMAIL" | "PUSH"Pre-configured notification template ID. Available templates are set up by M2P during onboarding.
Dynamic template parameter values. Keys and values depend on the template being used.
Response Body
application/json
application/json
curl -X POST "https://api.m2p.com/Yappay/notification-manager/send" \ -H "Content-Type: application/json" \ -d '{ "kitNo": "KIT20260306001234", "channel": "SMS", "templateId": "TXN_ALERT_001", "params": { "amount": "5000.00", "merchant": "Amazon", "date": "2026-03-06" } }'{
"status": "success",
"message": "Notification sent successfully"
}{
"result": null,
"exception": {
"detailMessage": "Mandatory field kitNo is missing",
"shortMessage": "Missing mandatory field",
"errorCode": "Y105",
"languageCode": "en"
},
"pagination": null
}Get foreign exchange rate for currency conversion POST
Retrieve the current foreign exchange rate for converting between two currencies. The response includes the base exchange rate, applied markup percentage, effective rate after markup, and a validity window for the quoted rate. The rate quote is time-limited. Use it within the validTill timestamp to ensure the quoted rate is honored. After expiry, request a fresh rate. Common use cases include displaying conversion rates to customers before international transactions, calculating forex charges, and pre-authorization amount estimation.
Generate a one-time password POST
Generate and send a one-time password (OTP) to a customer mobile number for verification of secure operations. The OTP is delivered via SMS to the registered mobile number. The purpose field defines what operation the OTP is for. Supported purposes include SET_PIN (for PIN setting), TRANSACTION (for high-value transactions), LOGIN (for authentication), and CARD_BLOCK (for card blocking confirmation). The kitNo is required for card-related operations (SET_PIN, CARD_BLOCK) to identify which card the OTP is associated with. OTPs have a limited validity period (typically 5 minutes) and a maximum of 3 validation attempts. Rate limited to prevent abuse.