CreateReceipt · LendMN Open Platform

Баримт бүртгэх

Гүйлгээний баримт бүртгэх

Гүйлгээний баримт бүртгэх хүсэлт:

METHOD	URL	HEADER
POST	`/api/w/receipt`	`content-type: application/x-www-form-urlencoded` `x-and-auth-token: {Token}`

Parameters

Параметер	Төрөл	Заавал	Тайлбар
transactionId	Number	Тийм	Гүйлгээний дугаар
amount	Number	Тийм	Баримтын дээрх дүн
currency	String	Үгүй	Баримтын вальют
receiptAdd	Number	Тийм	Баримт нэмэлт мэдээлэлтэй эсэх. 1-Тийм, 0-Үгүй
title	String	receiptAdd = 1 - Тийм, Бусад - Үгүй	Нэмэлт мэдээллийн гарчиг
description	String	receiptAdd = 1 - Тийм, Бусад - Үгүй	Нэмэлт мэдээллийн тайлбар
promoUrl	String	receiptAdd = 1 - Тийм, Бусад - Үгүй	Нэмэлт мэдээллийн хаяг
secretValue	String	receiptAdd = 1 - Тийм, Бусад - Үгүй	Нэмэлт мэдээлэлд ашиглагдах түлхүүр үг
hasTax	Number	Тийм	Е-Баримт мэдээлэл илгээсэн эсэх. 1-Тийм, 0-Үгүй
taxId	String	hasTax = 1 - Тийм, Бусад - Үгүй	Е-Баримт бүртгэлийн ДДТД дугаар
taxQrText	String	hasTax = 1 - Тийм, Бусад - Үгүй	Е-Баримт бүртгэлийн QR дугаар
taxLotteryId	String	hasTax = 1 - Тийм, Бусад - Үгүй	Е-Баримт бүртгэлийн сугалааны дугаар
taxIndividual	Number	hasTax = 1 - Тийм, Бусад - Үгүй	Е-Баримт хүлээн авагч 1 - Хувь хүн эсвэл 0 - Байгууллага эсэх
taxReceiver	String	Үгүй	Е-Баримт хүлээн авагчийн хэрэглэгчийн дугаар
taxReceiverPhone	String	Үгүй	Е-Баримт хүлээн авагчийн утасны дугаар
taxAmount	Number	hasTax = 1 - Тийм, Бусад - Үгүй	Е-Баримт системд бүртгүүлсэн гүйлгээний дүн
taxCurrency	String	hasTax = 1 - Тийм, Бусад - Үгүй	Е-Баримт системд бүртгүүлсэн гүйлгээний вальют
hasLoyalty	Number	Тийм	Урамшууллын системийн мэдээлэл илгээсэн эсэх. 1-Тийм, 0-Үгүй
loyaltySystem	String	hasLoyalty = 1 - Тийм, Бусад - Үгүй	Урамшууллын системийн нэр
loyaltyCardId	String	hasLoyalty = 1 - Тийм, Бусад - Үгүй	Урамшууллын системийн картын дугаар
loyaltyAdd	String	hasLoyalty = 1 - Тийм, Бусад - Үгүй	Урамшууллын онооны мэдээлэл нэмэх эсэх
loyaltyPoint	String	hasLoyalty = 1 - Тийм, Бусад - Үгүй	Урамшууллын нэмэгдэх (хасагдах) оноо
loyaltyBalance	String	hasLoyalty = 1 - Тийм, Бусад - Үгүй	Урамшууллын онооны баланс

`transactionId`

Гүйлгээний дугаар.

`amount`

Баримтын дээрх дүн.

`currency`

Баримтын вальют. Default = MNT

`receiptAdd`

Баримт нэмэлт мэдээлэлтэй эсэх.

`title`

Нэмэлт мэдээллийн гарчиг.

`description`

Нэмэлт мэдээллийн тайлбар.

`promoUrl`

Нэмэлт мэдээллийн хаяг.

`secretValue`

Нэмэлт мэдээлэлд ашиглагдах түлхүүр үг. Жишээ нь: Промо код ...

`hasTax`

Е-Баримт мэдээлэл илгээсэн эсэх.

`taxId`

Е-Баримт бүртгэлийн ДДТД дугаар.

`taxQrText`

Е-Баримт бүртгэлийн QR дугаар.

`taxLotteryId`

Е-Баримт бүртгэлийн сугалааны дугаар.

`taxIndividual`

Е-Баримт хүлээн авагч 1 - Хувь хүн эсвэл 0 - Байгууллага эсэх.

`taxReceiver`

Е-Баримт хүлээн авагчийн хэрэглэгчийн дугаар.

`taxReceiverPhone`

Е-Баримт хүлээн авагчийн утасны дугаар.

`taxAmount`

Е-Баримт системд бүртгүүлсэн гүйлгээний дүн.

`taxCurrency`

Е-Баримт системд бүртгүүлсэн гүйлгээний вальют.

`hasLoyalty`

Урамшууллын системийн мэдээлэл илгээсэн эсэх.

`loyaltySystem`

Урамшууллын системийн нэр.

`loyaltyCardId`

Урамшууллын картын дугаар.

`loyaltyAdd`

Урамшууллын онооны мэдээлэл нэмэх эсэх.

`loyaltyPoint`

Урамшууллын нэмэгдэх (хасагдах) оноо.

`loyaltyBalance`

Урамшууллын онооны баланс.

Response

Нэр	Төрөл	Тайлбар
code	Integer	Хариу код 0 - амжилттай эсвэл алдааны код
response	Mixed	Хэрвээ алдаа гарсан тохиолдолд алдааны тайлбар байна. Амжилттай бол дэлгэрэнгүй мэдээлэл.

Response-ын дэлгэрэнгүй

Нэр	Төрөл	Тайлбар
receiptNumber	Integer	Баримтын бүртгэлийн дугаар

`receiptNumber`

Баримтын бүртгэлийн дугаар.

Хүсэлт илгээж буй жишээ:

curl --request POST \
  --url 'https://mgw.test.lending.mn/api/w/receipt' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'x-and-auth-token: {token}' \
  --data 'transactionId={transactionId}&amount={amount}&currency={currency}&receiptAdd=1&title={title}&description={description}&promoUrl={promoUrl}&secretValue={secretValue}&hasTax=1&taxId={taxId}&taxQrText={taxQrText}&taxLotteryId={taxLotteryId}&taxIndividual={taxIndividual}&taxReceiver={taxReceiver}&taxReceiverPhone={taxReceiverPhone}&taxAmount={taxAmount}&taxCurrency={taxCurrency}&hasLoyalty=1&loyaltySystem={loyaltySystem}&loyaltyCardId=loyaltyCardId&loyaltyAdd={loyaltyAdd}&loyaltyPoint={loyaltyPoint}&loyaltyBalance={loyaltyBalance}'

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

{
  "code": 0,
  "response": {
    "receiptNumber": "1001"
  }
}

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

{
  "code": 400,
  "response": {
    "error": "invalid_client",
    "error_description": "The client credentials are invalid"
  }
}