Токен үүсгэх
Гүйлгээ хийлгүйгээр харилцагчийн картыг токен болгон хадгалах боломжтой. Ингэхийн тулд доорх зааврын дагуу дуудна.
Токен холбох шаардлагатай бол банканд хандан хүсэлт өгнө үү.
1. Нэхэмжлэх үүсгэх
Token үүсгэх хүсэлтэнд гүйлгээний дүнгүйгээр нэхэмжлэх үүсгэнэ. Гүйлгээний дүнг банк random байдлаар үүсгэх юм. Гүйлгээ хийгдсэний дараа 1-2 минутын дотор буцаалт хийгдэж харилцагчид буцаж орно. Доорх форматын дагуу хүсэлт үүсгэж, https://ecommerce.golomtbank.com/api/confirmation хаяг руу POST method-р шиднэ.
{
"callback": "string",
"checksum": "string",
"returnType": "string",
"transactionId": "string"
}
Параметрийн тайлбар
Parameters | Type | Тайлбар |
---|---|---|
callback | String | Харилцагчийн browser дээрээс callback буюу redirect хийх мерчантын url байна |
checksum | String | checksum = transactionId +amount + returnType + callback |
returnType | String | Мерчантын url рүү redirect хийх method-н POST GET утга байна. MOBILE үед app-н deeplink дуудна. |
transactionId | String | Мерчантын гүйлгээний дугаар байна. |
Амжилттай болсон үеийн хариу
{
"checksum": "9ac76e1ecd0cb23b25cf2dbf976de7bc4d6ff11aebfbd83216aae29be16534b8",
"transactionId": "test12345",
"invoice": "d7fb2858-df36-469e-b40d-2815fe9215cf"
}
Параметрийн тайлбар
Parameter | Type | Definition |
---|---|---|
checksum | String | Банк талаас үүсгэх checksumchecksum = invoice + transactionId |
transactionId | String | Мерчантын гүйлгээний дугаар байна |
invoice | String | Тухайн гүйлгээний дугаар дээр үүссэн нэмэмжлэхийн дугаар |
2. Хуудас дуудах
Үүссэн нэхэмжлэх дугаарыг ашиглан харилцагчийн browser дээр карт бөглөх хуудсыг дуудуулна.
Дараах форматын дагуу URL-г харилцагчийн веб дээр дуудуулна:
https://ecommerce.golomtbank.com/confirmation/ mn
or en
/ invoice
- Хэлний сонголт нь картын мэдээлэл оруулах хуудас монгол-
mn
эсвэл англи-en
хэлээр гарж ирэх сонголтыг илтгэнэ. - invoice нь нэхэжлэх үүсгэх хүсэлтийн хариунд ирсэн банкнаас үүсгэж өгсөн дугаар байна.
Жишээ URL:
https://ecommerce.golomtbank.com/confirmation/mn/4f2b614f-730b-406d-aaab-41ce2610fb36
https://ecommerce.golomtbank.com/confirmation/en/f64a28d8-7780-4b1a-b0f1-dee001ba741d
3. Токен авах
Токен үүсгэх хүсэлт амжилттай болсон эсэхийг шалгаж, токен дугаарыг авна. Доорх форматын дагуу хүсэлт үүсгэж, https://ecommerce.golomtbank.com/api/get/token хаяг руу POST method-р шиднэ.
{
"checksum": "string",
"transactionId": "string"
}
Параметрийн тайлбар
Parameters | Type | Тайлбар |
---|---|---|
checksum | String | checksum = transactionId + transactionId |
transactionId | String | Мерчантын гүйлгээний дугаар байна. |
Амжилттай болсон үеийн хариу
{
"bankCode": "159999",
"bank": "Голомт банк",
"errorDesc": "Амжилттай",
"checksum": "c7780078c2b8abacbce594bb7951d9d24c47858de683f9b6bc2e6d19adf965ae",
"errorCode": "000",
"cardHolder": "Gantulga A",
"transactionId": "test12345",
"cardNumber": "515023******7733",
"token": "cdbd3c51601db4a147c619ac592ca0cdca591ca1321a3059c4be5a81808175a7"
}
Параметрийн тайлбар
Parameter | Type | Definition |
---|---|---|
bankCode | String | Карт гаргагч банкны дугаар |
errorDesc | String | Статус кодны тайлбар эндээс харах |
checksum | String | checksum = transactionId + token |
errorCode | String | Гүйлгээний статус код эндээс харах |
cardHolder | String | Карт эзэмшигчийн нэр |
transactionId | String | Мерчантын гүйлгээний дугаар |
cardNumber | String | Гүйлгээ хийгдсэн картын дугаар |
token | String | Картыг илэрхийлэх токен дугаар |