Гүйлгээ шалгах

Гүйлгээ амжилттай эсвэл амжилтгүй явагдсаныг шалгаж баталгаажуулах.

Үйлчилгээний workflow

Хэрэглэгчээс ирүүлсэн гүйлгээний хүсэлтийг банк шалгаж SocialPay app-руу гүйлгээ амжилттай эсвэл амжилтгүй болсон талаарх мэдээллүүдийг response-р явуулна. Үүний дараа мерчант тал гүйлгээг батаажуулах хүсэлтийг банкны ../pos/invoice/check линк-рүү httpRequest POST method илгээж баталгаажуулна.

Гүйлгээг зайлшгүй шалгах шаардлагатай

Хэрэглэгчийн app дээр гүйлгээ хийгдсэн талаар харуулахад тухайн мэдээллийг үнэн зөв гэж батлах арга байхгүй тул аюулгүй байдлын үүднээс банкруу хүсэлт илгээж дахин шалгалт хийх хэрэгтэй.

Мерчант хүсэлт гаргахад шаардагдах параметрүүд

Json format:

{
  "amount": "String",
  "checksum": "String",
  "invoice": "String",
  "terminal": "String"
}

Parameters	Type	Тайлбар
amount	String	Шалгах гүйлгээний дүн
checksum	String	checksum = terminal + invoice + amount
invoice	String	Нэхэмжлэхийн дугаар (maxlen = 32)
terminal	String	Голомт банкнаас өгсөн 8 оронтой цифр байна

checksum-ын талаар дэлгэрэнгүй мэдээллийг энэ линкнээс уншина уу.

Амжилттай болсон үеийн хариу

Json format:

{
  "header": {
    "code": 200,
    "status": "success"
  },
  "body": {
    "response": {
      "approval_code": "924353",
      "amount": "1",
      "card_number": "515023******7151",
      "resp_desc": "Амжилттай",
      "resp_code": "00",
      "checksum": "ec36c52c6de0ac16a045e06717e2fba631b7e686c9d99785d338b387d8958cb0",
      "invoice": "2020020601",
      "terminal": "13133707"
    }
  }
}

Амжилтгүй болсон үеийн хариу

Json format:

{
  "header": {
    "code": 200,
    "status": "success"
  },
  "body": {
    "response": {
      "approval_code": "",
      "amount": "1",
      "card_number": "515023******7151",
      "resp_desc": "Үлдэгдэл хүрэлцэхгүй",
      "resp_code": "51",
      "checksum": "ec36c52c6de0ac16a045e06717e2fba631b7e686c9d99785d338b387d8958cb0",
      "invoice": "2020020601",
      "terminal": "13133707"
    }
  }
}

resp_code нь 2 оронтой String утга байх бөгөөд зөвхөн "00" үед амжилттай, бусад бүх тохиолдолд амжилтгүй болсоныг илтгэнэ.

Parameter	Type	Definition
approval_code	String	Картын систем дээр гүйлгээ амжилттай болсоныг илэрхийлэх дугаар
amount	String	Шалгасан гүйлгээний дүн
cardNumber	String	Гүйлгээ хийгдсэн картын дугаар масктай ирнэ
resp_desc	String	resp_code-н дэлгэрэнгүй тайлбар
resp_code	String	00 үед гүйлгээ амжилттай бусад тохиолдолд амжилтгүй
checksum	String	checksum = resp_code + invoice + amount + terminal
invoice	String	Байгууллагаас дамжуулах давхцахгүй гүйлгээний дугаар
terminal	String	Голомт банкнаас өгсөн 8 оронтой цифр байна

header тусгагдсан утгууд нь мерчантаас илгээсэн мэдээллүүд бүх шалгалтаа /validation/ давж үндсэн үйлдэл хийгдсэн эсэхийг илэрхийлж байгаа бөгөөд, цуцлалт амжилттай болсон эсэхийг body хэсгийн дата-наас харахыг анхаарна уу.

header object болон алдаатай үед явуулах хариутай энэ линкээр орж танилцана уу.