Fill AnyAmount Invoice with Client Info

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

POST/api/invoices/v1/unlimited/%invoice_id%/proceedAuth: Not Required

Authorization is not required as the invoice is provided to a non-registered client.

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 previously provided during creation.

paymentAmountnumberRequired

Amount entered by the client as a reference of amount to be received in invoiceCurrency. Required for frontend correct work, can have any desirable value for API-only processing.

More attributes

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

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

BODY

{
    "paymentCurrency": "usdc",
    "clientEmail": "client@example.com",
    "paymentAmount": 100,
    "invoiceCurrency": "eur"
}

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, qrCodeURL, qrCodeBase64.

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",
    "type": "unlimited",
    "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": {
        "items": [
            { "name": "Product 1" }
        ],
        "paymentCurrency": "trc20usdt",
        "isMerchantPaysFee": false,
        "paymentAmount": "100"
    },
    "redirectURL": "%url_for_DONE_statused_invoices_redirection%",
    "clientEmail": "client_mail@service.domain",
    "address": {
        "id": "%payment_address_id%",
        "address": "%payment_address%",
        "tag": null,
        "asset": "trc20usdt",
        "qrCodeURL": "string link to address QR-code generated",
        "qrCodeBase64": "string link to address QR-code generated in Base64"
    },
    "paymentDetails": {
        "rate": "1.16843920",
        "invoiceFee": "12.728032"
    },
    "expiredAt": "YYYY-MM-DDTHH:MM:SS.000Z"
}

Request Body​

Additional Response Fields​

Request Body

Additional Response Fields