espay logo

Send SMS

Semua permintaan yang masuk ke sistem espay akan divalidasi Signature. Signature dikirim pada setiap permintaan dengan parameter Signature. Setiap Signature akan di-hash menggunakan algoritma sha256. Signature akan dihasilkan dengan mengalikan beberapa nilai dari parameter nilai sebelumnya dan dengan kunci yang disediakan oleh espay. Format Signature berbeda dari layanan apa pun. Setiap parameter akan dimulai, dipisahkan, dan diakhiri dengan ##. Semua nilai akan diubah menjadi huruf besar. Urutan urutan Signature sebagai berikut:

  1. sender_id
  2. rq_uuid
  3. message_type
  4. phone_number
  5. signaturekey

Jadi format penggabungan signature adalah sebagai berikut:

#sender_id#rq_uuid#message_type#phone_number#signaturekey#
Contoh menghasilkan signature

Format Awal

#SGOPLUS#smspr-test-011#SMS#6281218816222#

Ubah menjadi kapital

#SGOPLUS#SMSPR-TEST-011#SMS#6281218816222#

Tambahkan signature key

#SGOPLUS#SMSPR-TEST-011#SMS#6281218816222#sgoplus201711aa#

Hash dengan algoritma sha256

3ac657060474d31095e27eb49699098c81b317ca9d34e39489c9f77ba80ab758

API URL

development: http://domain.espay/btext/send/outgoing
production: http://domain.espay/btext/send/outgoing

Send SMS

Parameter request

Parameter Name Attribute Mandatory Description
rq_uuid 64 Ya Meminta pengenal. ID unik untuk mengidentifikasi pesan ini dengan pesan lain
sender_id 32 Ya Sender Identifier akan diberikan oleh espay
message_type 3 Ya Isi fix value = SMS
phone_number 14 Ya Nomor seluler tujuan
message 200 Ya Meminta teks pesan
signature 64 Ya Signature (lihat algoritma signature

Parameter Response

Parameter Name Attribute Mandatory Description
rq_uuid 64 Ya Meminta pengenal. ID unik untuk mengidentifikasi pesan ini dengan pesan lain
rs_datetime 19 Ya Tanggal transaksi di server aplikasi
Format : YYYY-MM-DD HH:MM:SS Ex : 2014-12-17 12:30:45
error_code 4 Ya Error kesalahan
error_message Ya Deskripsi Kesalahan

Error Code List

Error Code Error Message
0000 success
0041 Invalid Recipient
0601 IP Address Rejected / Unregistered
0001 invalid request
0096 invalid message type
0050 Parameters Should be not empty
0015 Unable to process, please contact your administrator
0401 Action decline
800 Insufficient balance
0011 Invalid signature 
  
  

  
Contoh Request

  
POST /btext/send/outgoing HTTP/1.1
Host: domain.espay
Connection: keep-alive
Content-Length: 250
Content-Type: application/x-www-form-urlencoded
Accept: */*

rq_uuid=fbd39734-ed32-490d-98c4-e91bcd91037a
&sender_id=21102509019CO9R
&message_type=SMS
&phone_number=6285333332113
&message=noteshere
&signature=3ac657060474d31095e27eb49699098c81b317ca9d34e39489c9f77ba80ab758
    
  
  
Contoh Response

    {
       {
          "rq_uuid": "baefa025e0ca44861a9076c8Z83fccxx",
          "rs_datetime": "2018-02-27 11:57:45",
          "error_code": "0000",
          "error_message": ""
      }