Create invoice · LendMN Open Platform

Нэхэмжлэл үүсгэх

Нэхэмжлэлийг хүлээн авагч тодорхой үед үүсгэж болно эсвэл хүлээн авагч тодорхойгүй үед үүсгэж болно.

Хэрэглэгч тодорхой үед нэхэмжлэл амжилттай үүсвэл хэрэглэгчийн LendMN app дээр сонордуулга ирэх болно.

Утасны дугаар болон хэрэглэгчийн хэтэвчний дугаар ашиглаж нэхэмжлэл үүсгэх хүсэлт:

METHOD	URL	HEADER
POST	`/api/payment/create-invoice`	`Content-Type: application/json` x-and-auth-token: Token

Parameters

Параметер	Төрөл	Заавал	Тайлбар
amount	Number	Тийм	Нэхэмжлэгдэх мөнгөн дүн
expiredDate	String	Үгүй	Нэхэжлэлийн цуцлагдах огноо
description	String	Үгүй	Нэхэмжлэлийн гүйлгээний утга
externalId	String	Тийм	externalId нь мерчант нэхэмжлэлийг таних зорилготой өөрийн мэдээллээ хадгалах талбар. (50 хүртэлх тэмдэгт)
userWalletNumber	String	Тийм	Нэхэмжлэл хүлээн авагчийн хэтэвчийн дугаар
lendPay	Boolean	lendPay = true - Тийм, false - Үгүй	ЛэндПэй-н нэхэмжлэл эсэх

`Token`

Мерчантын урт хугацааны Token. Энэхүү Token-ыг мерчант үүсгэх үед хүчинтэй хугацаа тохируулж үүсгэнэ.

`amount`

Нэхэмжлэгдэх мөнгөн дүн.

`expiredDate`

Нэхэжлэлийн цуцлагдах огноо. _{* Огноо илгээгүй үед 30 мин дараа цуцлагдах нэхэмжлэл үүснэ.}

`description`

Нэхэмжлэл ирэх үед мөн нэхэмжлэлийн дэлгэрэнгүй үзэх үед нэхэмжлэлийн гүйлгээний утга дэлгэцэнд харагдах болно.

`externalId`

externalId нь мерчант нэхэмжлэлийг таних зорилготой өөрийн мэдээллээ хадгалах талбар.

`userWalletNumber`

Нэхэмжлэл хүлээн авагчийн QR-г уншуулж хэрэглэгчийн хэтэвчний дугаарыг авч илгээнэ. userWalletNumber- хэтэвчний дугаартай хэрэглэгч рүү нэхэмжлэл илгээх.

`lendPay`

ЛэндПэй-н нэхэмжлэл эсэх default = false
true - тийм
false - үгүй

Response

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

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

Нэр	Төрөл	Тайлбар
id	String	Нэхэмжлэлийн id
createdAt	String	Нэхэмжлэл үүссэн огноо
expiredDate	String	Нэхэмжлэл цуцлагдах огноо
amount	Integer	Нэхэмжлэлийн дүн
status	Integer	Нэхэмжлэлийн төлөв
description	Integer	Нэхэмжлэлийн гүйлгээний утга
externalId	Integer	Нэхэмжлэлийг таних зорилготой мэдээлэл
invoiceNumber	String	Нэхэмжлэлийн дугаар
qr	String	Mobile app болон browser-р Лендмн нээгдэх deeplink

`id`

Нэхэмжлэлийн id.

`createdAt`

Нэхэмжлэл үүссэн огноо.

`expiredDate`

Нэхэмжлэл цуцлагдах огноо.

`amount`

Нэхэмжлэлийн мөнгөн дүн.

`status`

Нэхэмжлэлийн төлөв:
0: Хүлээгдэж байгаа
1: Хийгдэж буй
2: Төлөгдсөн
3: Цуцлагдсан.

`description`

Нэхэмжлэлийн гүйлгээний утга.

`externalId`

Нэхэмжлэлийг таних зорилготой мэдээлэл .

`invoiceNumber`

Нэхэмжлэлийн дугаар энэхүү дугаарыг ашиглаж нэхэмжлэлийн дэлгэрэнгүй мэдээллийг авч болно.

`qr`

Дэлгэцэн дээр харуулах QR кодын дата.

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

curl --request POST \
  --url 'https://mgw.test.lending.mn/api/payment/create-invoice' \
  --header 'Content-Type: application/json' \
  --header 'x-and-auth-token: {token}' \
  --data-raw '{
     "amount": {amount},
     "expiredDate": {expireddate},
     "receiverWalletId": {receiverWalletId},
     "organizationId": {organizationId},
     "description": {description},
     "externalId": {externalId},
     "userWalletNumber": {userWalletNumber},
     "lendPay": true
  }'

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

{
  "code": 0,
   "response": {
      "id": 1,
      "createdAt": {
         "date": "2022-01-01 01:01:53.330417",
         "timezone_type": 3,
         "timezone": "Asia/Shanghai"
      },
      "updatedAt": {
         "date": "2022-01-01 01:01:53.330367",
         "timezone_type": 3,
         "timezone": "Asia/Shanghai"
      },
      "expiredDate": {
         "date": "2022-01-02 01:01:53.000000",
         "timezone_type": 3,
         "timezone": "Asia/Shanghai"
      },
      "completedDate": null,
      "amount": 1000,
      "status": 0,
      "receiverWalletId": "1",
      "receiverWalletNumber": null,
      "userId": null,
      "organizationId": 1,
      "description": "description",
      "externalId": "tracking_data",
      "paidAmount": 0,
      "holdAmount": 0,
      "feeAmount": 0,
      "currencyCode": "MNT",
      "rateTypeId": null,
      "feeTypeId": null,
      "downPayment": 0,
      "invoiceNumber": "86b84665-7e82-4318-83ba-68d1b834daec",
      "optionalData": null,
      "qr": "https://pay.and.global/p/i/86b84665-7e82-4318-83ba-68d1b834daec",
      "transactionType": 7,
      "payments": []
   }
}

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

{
   "code": 401,
   "response": "Access denied"
}