mongolian-payment-paylink

PayLink card payment SDK for Python — create invoices, query transactions, run reports.

Wraps the PayLink External API (single POST /external/process endpoint, process-code driven).

Installation

pip install mongolian-payment-paylink

Requires Python >= 3.8. Depends on httpx.

Quick Start

from mongolian_payment_paylink import PayLinkClient, PayLinkConfig, CreateInvoiceInput

client = PayLinkClient(PayLinkConfig(
    base_url="https://paylink.mn/api/v1",   # test: https://pay-link.fiba.mn/api/v1
    username="MERCHANT_USERNAME",
    signature_key="YOUR_SIGNATURE_KEY",
))

invoice = client.create_invoice(CreateInvoiceInput(
    amount_total=10000,
    count_total=1,
    amount=10000,
    description="Order #123",
    merchant_ref="ORDER-123",
))
print(invoice.payment_link)   # redirect the buyer here
print(invoice.invid)

Async

import asyncio
from mongolian_payment_paylink import AsyncPayLinkClient, PayLinkConfig

async def main():
    async with AsyncPayLinkClient(PayLinkConfig(
        base_url="https://paylink.mn/api/v1",
        username="MERCHANT_USERNAME",
        signature_key="YOUR_SIGNATURE_KEY",
    )) as client:
        detail = await client.get_invoice("INV-123")
        print(detail["status"])

asyncio.run(main())

Authentication & signing

Every request sends three headers: pc (process code), X-USERNAME, and X-SIGNATURE.

Note on the signature. PayLink's exact signing scheme is not published. By default this SDK signs the HMAC-SHA256 (hex) of the JSON request body, keyed by signature_key. If PayLink specifies a different scheme, pass your own sign function — it receives the exact body string and returns the signature:

PayLinkConfig(base_url=..., username=..., sign=lambda body: my_signature(body))

Environment variables

PAYLINK_BASE_URL=https://paylink.mn/api/v1
PAYLINK_USERNAME=MERCHANT_USERNAME
PAYLINK_SIGNATURE_KEY=your-signature-key

from mongolian_payment_paylink import PayLinkClient, load_config_from_env
client = PayLinkClient(load_config_from_env())

Methods

List/report/summary results are returned as plain dicts/lists exactly as the API sends them (snake_case keys). create_invoice maps to the CreatedInvoice dataclass.

Dates use the YYYY-MM-DD HH24:MI:SS format.

Endpoints

Error handling

Every call returns HTTP 200; the result is driven by response_code (RC000000 = success). Non-success codes and transport errors raise PayLinkError:

from mongolian_payment_paylink import PayLinkError

try:
    client.get_invoice("INV-404")
except PayLinkError as err:
    print(err)                 # "PayLink cu0904 failed: RC000015 - Record not found"
    print(err.response_code)   # "RC000015"
    print(err.status_code)     # set for HTTP-level failures
    print(err.response)        # raw response body

License

MIT