SMS Transmit

9min

About SMS Transmit
﻿
This ﻿ uses to send messages to ﻿s from a ﻿ or other related parties. ﻿ has Single ﻿ transmit and is supported by 4 popular Provider ﻿s in ﻿; Telkomsel, Indosat Ooredoo Hutchison, XL, dan Smartfren.
Ensure your ﻿ token ﻿ is sufficient before ﻿ing with this ﻿ Transmit ﻿. ﻿ navigate to Balance Deposits﻿ for more detailed ﻿ regarding ﻿ ﻿s.
﻿
Specification - SMS Transmit
﻿
API url
/nicepay/direct/v2/sms-transmit
Request Method 
﻿POST 
Merchant Token
SHA256 (timestamp+ iMid+ msgRefNo+ merchantKey)
﻿
Request Parameter for SMS Transmit
﻿
Parameter
Type
Size
Description
Example / Notes
timeStamp
﻿Required﻿
N
14
﻿﻿ Request Date
20221219110059
iMid
﻿Required﻿
AN
10
﻿﻿ ID
IONPAYTEST
msgRefNo
﻿Required﻿
ANS
40
﻿﻿ Order Number (Key from ﻿)
MerchantReferenceNumber001
smsType
﻿Required﻿
N
1
﻿﻿ Type
0 : Normal 
1 : Alert 
2 : OTP
2
reservedFlag
﻿Required﻿
N
1
Sending Type
0 : Realtime Processing 
1 : Batch Processing
0
reservedDt
N
8
Send Date Request
(YYYYMMDD) 
﻿
reservedTm
N
6
Send Time Request
(HH24MiSS)
﻿
sender
AN
11
Sender’s Number or Masking
JATI_TSEL_IONPAYTEST001
recipientNo
﻿Required﻿
N
16
Recipient's Mobile Number
+6281294529025
smsMsg
﻿Required﻿
ANS
640
Message Content
﻿
dbProcessUrl
﻿Required﻿
AN
255
Result Notification URL
(Async Notification)
https://nicetest.requestcatcher.com/test
reqNm
﻿Required﻿
AN
30
Requestor PIC Name
﻿
merchantToken
﻿Required﻿
AN
255
﻿﻿ Token


9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199
﻿
Response Parameter for SMS Transmit
﻿
Parameter
Type
Size
Description
Example / Notes
resultCd
N
14
﻿Result Code﻿ 
0000
resultMsg
AN
255
Response Message
SUCCESS
tXid
AN
30
﻿﻿ Order Number 
(Key From ﻿)
IONPAYTEST10202212191102221919
﻿
When Success
msgStatus
N
2
﻿Transmission Status Code﻿﻿
﻿
﻿
Sample JSON for SMS Transmit
﻿
JSON Request
JSON Response
Java Request
requestMap.put("timeStamp", "20221219110059");
requestMap.put("iMid", "IONPAYTEST");
requestMap.put("merchantToken", 
"9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199");
requestMap.put("msgRefNo","MSG-20221219110059");
requestMap.put("smsType", "2");
requestMap.put("reservedFlag", "0");
requestMap.put("reservedDt", "");
requestMap.put("reservedTm", "");
requestMap.put("sender","JATI_TSEL_IONPAYTEST001");
requestMap.put("recipientNo","+6281294529025");
requestMap.put("smsMsg","Testing masukkan kode 123456 dalam 30 menit.");
requestMap.put("dbProcessUrl", "https://nicetest.requestcatcher.com/test");
requestMap.put("reqNm", "NICEPAY")
requestMap.put("timeStamp", "20221219110059");
requestMap.put("iMid", "IONPAYTEST");
requestMap.put("merchantToken", 
"9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199");
requestMap.put("msgRefNo","MSG-20221219110059");
requestMap.put("smsType", "2");
requestMap.put("reservedFlag", "0");
requestMap.put("reservedDt", "");
requestMap.put("reservedTm", "");
requestMap.put("sender","JATI_TSEL_IONPAYTEST001");
requestMap.put("recipientNo","+6281294529025");
requestMap.put("smsMsg","Testing masukkan kode 123456 dalam 30 menit.");
requestMap.put("dbProcessUrl", "https://nicetest.requestcatcher.com/test");
requestMap.put("reqNm", "NICEPAY")
﻿
﻿
See also
﻿﻿ ﻿ Notification SMS﻿ ﻿ to learn ﻿ ﻿ detail used to send ﻿.
﻿﻿ ﻿ SMS Inquiry﻿ ﻿ to know detail further of ﻿ ﻿ used to perform inquiry.

API url	/nicepay/direct/v2/sms-transmit
Request Method	POST
Merchant Token	SHA256 (timestamp+ iMid+ msgRefNo+ merchantKey)

Parameter	Type	Size	Description	Example / Notes
timeStamp Required	N	14	Request Date	20221219110059
iMid Required	AN	10	ID	IONPAYTEST
msgRefNo Required	ANS	40	Order Number (Key from )	MerchantReferenceNumber001
smsType Required	N	1	Type 0 : Normal 1 : Alert 2 : OTP	2
reservedFlag Required	N	1	Sending Type 0 : Realtime Processing 1 : Batch Processing	0
reservedDt	N	8	Send Date Request (YYYYMMDD)
reservedTm	N	6	Send Time Request (HH24MiSS)
sender	AN	11	Sender’s Number or Masking	JATI_TSEL_IONPAYTEST001
recipientNo Required	N	16	Recipient's Mobile Number	+6281294529025
smsMsg Required	ANS	640	Message Content
dbProcessUrl Required	AN	255	Result Notification URL (Async Notification)	https://nicetest.requestcatcher.com/test
reqNm Required	AN	30	Requestor PIC Name
merchantToken Required	AN	255	Token	9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199

Parameter	Type	Size	Description	Example / Notes
resultCd	N	14	Result Code	0000
resultMsg	AN	255	Response Message	SUCCESS
tXid	AN	30	Order Number (Key From )	IONPAYTEST10202212191102221919 When Success
msgStatus	N	2	Transmission Status Code

SMS API

Notification SMS

SMS Transmit

About SMS Transmit

Specification - SMS Transmit

Request Parameter for SMS Transmit

Response Parameter for SMS Transmit

Sample JSON for SMS Transmit

See also

Welcome to NICEPAY DOCS