Fill Regular Invoice with Client Info

This endpoint fills a regular invoice with client's info — email address and payment asset (if not pre-defined by merchant during creation).

POST/api/invoices/v1/regular/%invoice_id%/proceedAuth: Optional

Authorization is not required as the invoice is provided to a non-registered client and uses their email to identify the person as an invoice payee.

Request Body

clientEmailstringRequired

Client's email. Should meet standard email format.

paymentCurrencystringRequired

Asset name + network the client wants to pay with. Values: btc, eth, trc20usdt, usdterc20, sol, ton, usdc, bnb, ltc, trx, bch. Ignored if paymentCurrency was previously provided during invoice creation or its value was null.

POST/api/invoices/v1/regular/%invoice_id%/proceed

curl --location 'https://my.paidlys.com/api/invoices/v1/regular/%invoice_id%/proceed' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_PUBLIC_TOKEN' \
  --data '<body>'

BODY

{
    "paymentCurrency": "sol",
    "clientEmail": "client@example.com"
}

Additional Response Fields

Fields available after the invoice is filled (not available for "Created" status):

clientEmailstring

Client's email.

addressobject

Payment address: id, address, tag (null if not TON), asset.

paymentDetailsobject

Payment details object.

expiredAtstring

Invoice expiration time. 30 min for all assets, 120 min for BTC.

EXAMPLE RESPONSE

{
    "id": "%invoice_id%",
    "status": "%invoice_status%",
    "createdAt": "YYYY-MM-DDTHH:MM:SS.000Z",
    "company": {
        "name": "%company_name%",
        "logoUrl": "%logo_url%",
        "assets": [
            { "asset": "btc", "isAllowed": true },
            { "asset": "eth", "isAllowed": false },
            { "asset": "usdt", "isAllowed": true },
            { "asset": "sol", "isAllowed": false },
            { "asset": "ton", "isAllowed": false },
            { "asset": "usdc", "isAllowed": false },
            { "asset": "bnb", "isAllowed": false },
            { "asset": "ltc", "isAllowed": false },
            { "asset": "near", "isAllowed": false },
            { "asset": "trx", "isAllowed": false },
            { "asset": "bch", "isAllowed": false }
        ]
    },
    "invoiceContent": {
        "invoiceCurrency": "eur",
        "items": [
            { "name": "Coffee", "price": "1000" },
            { "name": "Sugar", "price": "1" },
            { "name": "Regular client discount", "price": "-3" }
        ],
        "paymentCurrency": "trc20usdt",
        "isMerchantPaysFee": false
    },
    "redirectURL": "%url_for_DONE_statused_invoices_redirection%",
    "clientEmail": "client_mail@service.domain",
    "address": {
        "id": "%payment_address_id%",
        "address": "%payment_address%",
        "tag": null,
        "asset": "trc20usdt"
    },
    "paymentDetails": {
        "rate": "1.16843920",
        "invoiceFee": "12.728032"
    },
    "expiredAt": "YYYY-MM-DDTHH:MM:SS.000Z"
}

Request Body​

Additional Response Fields​

Request Body

Additional Response Fields