Танилцуулга

Нийтлэг үндэслэл

Epay нь fintech хоорондын QR гүйлгээний санхүүгийн бус хэсгийн switching system юм. Уг системд холбогдсон fintech-үүд нь Төлбөр хүлээн авах, Төлбөр төлөх аль аль оролцох боломжтой юм. Энэхүү гарын авлага нь эдгээр fintech-үүд EPay системтэй хэрхэн холбогдох талаарх зааварчилгаа юм.

Client - Харилцагч

Epay үйлчилгээнд холбогдож байгаа fintech.

Customer - Хэрэглэгч

Хэрэглэгч гэдэг нь төлбөр хүлээн авах Мерчант, эсвэл төлбөр шилжүүлэх Воллет-ийг төлөөлсөн fintech-ийн харилцагчийг нэрлэнэ.

Connection - Холболт

Client нь EPay-ийн server-тэй REST API-аар холбогдоно.

1. Харилцагч нь message хүлээн авах url-ээ EPay-д өгнө.
2. EPay нь тухайн харилцагчийг бүртгээд CLIENT_KEY үүсгэж өгнө.
3. Харилцагч нь EPay рүү https://dev-switch.epayment.mn/api/message url-ээр хандахдаа CLIENT_KEY-ээ ашиглана.
4. EPay нь харилцагчийн өгсөн url-ээр хандахдаа мөн CLIENT_KEY-ээ ашиглана.

Жишээ

Харилцагч EPay-тэй холбогдох жишээ

Төлбөр төлөхдөө Мерчантын үүсгэсэн QR code-ийг уншуулаад EPay рүү илгээж нэхэмжлэлийн мэдээллийг авна

POST https://dev-switch.epayment.mn/api/message

Headers:

• Content-Type: application/json
• X-Api-Key: CLIENT_KEY

Body (JSON):

{
  "msgType": "QR_INQUIRY",
  "trxInfo": {
    "qrcPayload": "00020101021226400014A00000084300010104009502106128328515520489995303496540450005802MN5907Enkhsod6011ULAANBAATAR61051100062200116INV173104207832280020163044d2d",
    "paymentCode": "673583de0eb301079b6106e8",
    "customerName": "Enkhsod",
    "customerCode": "10222",
  }
}

• qrcPayload: Emvco стандартын QR код дата
• paymentCode: Воллет талаас үүсгэсэн дахин давхардахгүй төлбөрийн дугаар
• customerName: Харилцагчийн нэр
• customerCode: Харилцагчийн код

Response:

{
    "invoiceCode": "INV1731559554641",
    "qrCode": "00020101021226400014A00000084300010104005102106128328515520489995303496540450005802MN5907Enkhsod6011ULAANBAATAR61051100062200116INV17315595546418002016304d379",
    "beneficiary": {
        "bankName": "Hi Payment solutions",
        "bankCode": "0051",
        "accountNumber": "6128328515",
        "accountName": "Enkhsod",
        "accountCurrency": "MNT"
    },
    "amount": 5000,
    "currency": "MNT",
    "description": "Тестийн гүйлгээ 1",
    "invoiceStatus": "NEW",
    "invoiceStatusDate": "2024-11-14T04:45:54.644Z",
    "transactionType": "PURCHASE",
    "isAllowCard": false,
    "createdAt": "2024-11-14T04:45:54.648Z",
    "updatedAt": "2024-11-14T04:52:59.583Z",
    "trxId": "23688577-d8a6-4160-95a6-fe37f343b7b6",
    "paymentCode": "673583de0eb301079b6106e8",
    "paid": null
}

• invoiceCode: Мерчант талаас үүсгэсэн дахин давхардахгүй нэхэмжлэхийн дугаар