SMS WS BillUpdate v1.1

Ti liu tch hp SMS qua NgnLng.vn

1

Hng dn to WS khi tch hp SMS qua Ngn Lng

tch hp SMS, site ngi bn (ngi nhn) cnto hm WS theo yu cu sau: Tn hm: BillUpdate(reciver_email, transaction_id, price, amount, fee, ref_code, keyword, service_id, message, client_mobile, telco, checksum)

Thng tin cc tham s u vo:

reciver_email: a ch email chnh ca ti khon nhn tin giao dch SMS trn Ngn Lng

transaction_id: m giao dch SMS trn Ngn Lng

price: s tin ngi dng b mt khi nhn tin n u s. VD: nhn tin ti u s 8681 mt 10.000 th gi tr price = 10000

amount: s tin ti khon ngi nhn nhn c vi giao dch SMS trn. VD: nhn tin ti u s 8681 mt 10.000, Ngn Lng thu ph 75% th gi tr amount = 7500

fee: s tin Ngn Lng thu ph cho giao dch SMS trn. Cng thc: fee = price amount

ref_code: m tham chiu, y l mt phn trong ni dung tin nhn m ngi dng nhn tin ln u s theo hng dn ca ch site.

VD: ngi dng nhn tin NL NAPTIEN nguyen van a th gi tr NL NAPTIEN l keyword Ngn Lng cp cho ngi nhn(ch site), cn nguyen van a l m tham chiu ref_code

keyword: t kha trong ni dung tin nhn ca ngi dng, vi v d trn th keyword = NL NAPTIEN

service_id: u s ngi dng nhn tin n, VD: service_id = 8681

message: y l ton b ni dung tin nhn ca ngi dng. VD: message = NL NAPTIEN nguyen van a

client_mobile: s in thoi ngi dng s dng nhn tin. VD: client_mobile = 0987654321

telco: m nh mng ca s in thoi nhn tin n. Nhn cc gi tr sau: o VIETTEL (mng Viettel) o VNP (mng Vinaphone) o VMS (mng Mobifone) o VNM (mng Vietnamobile) o SFONE (mng Sfone) o GTEL (mng Gmobile hoc Beeline c)

checksum: m kim tra, m ny c s dng kim tra gi tr cc tham s tr v c hp l hay khng.

Ti liu tch hp SMS qua NgnLng.vn

2

Tham s u ra:

- Tham s u ra l mt chui c cu trc : [ErrorCode]|[MessageSMS] - Trong :

o ErrorCode : nhn 2 gi tr l 0 v 1. Tr v gi tr 0 nu c li khi x l kt qu tr v trn h thng merchant. Tr v gi tr l 1 nu x l thnh cng.

o MessageSMS : l chui ni dng tin nhn c m ha base64 m merchant mun gi n ngi dng nhn tin. Chui ni dung tin nhn khng c qu 150 k t, v l ting vit khng du.

- VD: nu mun nhn tin phn hi n ngi dng vi ni dung Ban da nap tien vao he thong thanh cong th gi tr cn tr li ca hm BillUpdate l: 1|QmFuIGRhIG5hcCB0aWVuIHZhbyBoZSB0aG9uZyB0aGFuaCBjb25n

iu kin kim tra:

- Khi nhn c cc gi tr trn, hm BillUpdate cn to m kim tra theo cch sau : makiemtra = md5(reciver_email + "|" + transaction_id + "|" + price + "|" + amount + "|" + fee + "|" + ref_code + "|" + keyword + "|" + service_id + "|" + message + "|" + client_mobile + "|" + telco + "|" + Mt khu xc nhn giao dch) Trong : Mt khu xc nhn giao dch l gi tr c ngi nhn khai bo khi ng k mt keyword khi s dng dch v SMS ca Ngn Lng. Gi tr ny ch c thay i khi ngi nhn yu cu Ngn Lng

- Tip n hm BillUpdate cn kim tra: o Nu makiemtra == checksum (m kim tra ng) th x l np tin, cng im (ty theo merchant) v hm BillUpdate cn tr li gi tr l 1 o Nu makiemtra != checksum (li m kim tra) th khng x l g trn h thng merchant, hm BillUpdate cn tr li gi tr l 0

Din gii:

- Khi giao dch c thc hin (ngi dng nhn tin) th Ngn Lng s t ng gi WS bn pha merchant. Trong WebService merchant s nhn cc thng tin bn Ngn Lng gi sang, sau kim tra xem tham s checksum gi n c tha mn iu kin kim tra trn hay khng, nu tha mn th khch hng s thc hin vic x l tip theo v hm BillUpdate cn tr li gi tr l 1, nu khng th tr li gi tr l 0.