Fill Business Invoice with Client Info

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

POST/api/invoices/v1/business/%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. Values: btc, eth, trc20usdt, usdterc20, sol, ton, usdc, bnb, ltc, trx, bch. Ignored if previously provided during creation.

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

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

BODY

{
    "paymentCurrency": "trc20usdt",
    "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, 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": "regular",
    "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
    },
    "invoiceNumber": "INV-123",
    "seller": {
        "name": "Company Name",
        "phone": "+1234567890",
        "taxId": "TAX123456",
        "address": "123 Business St, City, Country"
    },
    "buyer": {
        "name": "Customer Name",
        "email": "customer@example.com",
        "phone": "+0987654321",
        "taxId": "CUST789012",
        "address": "456 Customer Ave, City, Country"
    },
    "taxes": [
        { "name": "VAT", "amount": 21 }
    ],
    "notesToBuyer": "Thank you for your business!",
    "internalNotes": "Internal notes for accounting",
    "issueDate": "2024-01-15",
    "dueDate": "2024-02-15",
    "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