Push Notification

Тайлбар

Мерчант тал банкнаас төлбөр төлөгдсөн мэдээллийг back-end to back-end дамжуулан хүлээж авна. Ингэснээр хэрэглэгчийн төхөөрөмж, веб хөтөч, интернер холболтоос үүсэн мэдээллийг авч чадахгүй байх эрсдлээс сэргийлж, төрбөрийн статусыг банкнаас давхар хүлээж авах болно.

Банкнаас тавих шаардлагууд

Үйлчилгээг авахын тулд мерчант нь notification хүлээж авах API-н url-ыг банкинд бүртгүүлсэн байх шаардлагатай.

API нь ганцхан POST method-г дэмждэг байх шаардлагатай. GET, PUT ,DELETE гэх зэрэг бусад method-г disable хийсэн байх.

SSL тохируулсан байх шаардлагатай

Банкнаас явуулах мэдээллийн хэлбэр


Protocol	HTTP
Method	POST
Content-Type	application/json

Гүйлгээ амжилттай үеийн жишээ

{
  "amount": "1",
  "bank": "Голомт банк",
  "errorDesc": "Амжилттай",
  "checksum": "8e2538fac797d6828.....................3c6863f60aac",
  "errorCode": "000",
  "cardHolder": "9496250",
  "transactionId": "test000001",
  "cardNumber": "949625******0003",
  "token": "9ffd1bb0544990........b0feaae5f8ee3d824e"
}

Гүйлгээ амжилтгүй үеийн жишээ

{
  "amount": "1",
  "bank": "Голомт банк",
  "errorDesc": "Картын хугацаа дууссан",
  "checksum": "8e2538fac797d6828ca93c34a4487c54e75803a18978d425dfec3c6863f60aac",
  "errorCode": "300",
  "cardHolder": "9496250",
  "transactionId": "test000001",
  "cardNumber": "949625******0003"
}

Параметрүүд

Parameter	Type	Definition
amount	String	Картаас хасалт хийсэн мөнгөн дүн
bank	String	Карт гаргагч банкны нэр
errorDesc	String	Гүйлгээний статус тайлбар
checksum	String	`checksum` = `transactionId` + `errorCode` + `amount` + `token` Токен үүсээгүй үед `token` талбарыг оролцуулахгүй байна.
errorCode	String	`000` гүйлгээ амжилттай `300` амжилтгүй `errorDesc` дээр дэлгэрэнгүй ирнэ
cardHolder	String	Карт эзэмшигчийн нэр
transactionId	String	Мерчантын гүйлгээний дугаар
cardNumber	String	Гүйлгээ хийгдсэн картын дугаар
token	String	Картыг илэрхийлэх токен дугаар

token нь зөвхөн гүйлгээ амжилттай болсон тохиолдолд мерчант-д олгогдох картын мэдээллийг илэрхийлэх утга байна. Энэ үед урьдаас token авах тохиргоо буюу genToken параметрийг банкнаас нэхэмжлэх үүсгэх хүсэлтэн дээр "Y"-д тохируулсан байх шаардлагатай.

API

Checksum

API