Нэхэмжлэх цуцлах · Голомт Банк

Голомт банкны API-аас үүсгүүлсэн нэхэмжлэх дугаарыг устгуулах хүсэлт гаргах.

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

Нэхэмжлэхийг цуцлахын тулд тухайн нэхэмжлэх дугаарын илэрхийлж буй мэдээллүүд болох гүйлгээний дугаар, дүн болон терминалын дугаар зэргийг ../pos/invoice/cancel линк-рүү httpRequest POST method ашиглан илгээнэ. Үүнд банкны системээс хүсэлт амжилттай эсвэл амжилтгүй болсон талаарх мэдээлэл агуулсан response ирнэ.

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

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": {
      "desc": "Нэхэмжлэх амжилттай устгагдлаа.",
      "status": "SUCCESS"
    }
  }
}

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

Json format:

{
  "header": {
    "code": 200,
    "status": "success"
  },
  "body": {
    "response": {
      "desc": "Нэхэмжлэх төлөгдсөн байна.",
      "status": "ALREADYPAID"
    }
  }
}

Parameter	Type	Definition
desc	String	`status`-ын талаарх тайлбар
status	String	`ALREADYPAID` нэхэмжлэх төлөгдсөн тул устгах боломжгүй. `SUCCESS` амжилттай устгагдсан. `FAILED` амжилтгүй.

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

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