Get Started

Client API Quick Start

Start creating and tracking invoices in minutes.

Quick Start

Integrate in 4 Steps

Use these steps to authenticate, create invoice, and check status quickly.

Step 1: Configure Base URL

https://merchant.letsia-pay.com/client-api

Step 2: Login and Get Access Token

curl -X POST "https://merchant.letsia-pay.com/client-api/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email":"[email protected]",
    "password":"secret",
    "device_name":"postman"
  }'

Use returned token in header:

Authorization: Bearer TOKEN_VALUE

Step 3: Create Invoice

curl -X POST "https://merchant.letsia-pay.com/client-api/invoices" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN_VALUE" \
  -d '{
    "customer_email":"[email protected]",
    "amount":150.75,
    "title":"New Payment",
    "payment_methods":[1,2]
  }'

Step 4: Check Invoice Status

curl -X GET "https://merchant.letsia-pay.com/client-api/invoices/UID-1-001/status" \
  -H "Authorization: Bearer TOKEN_VALUE"

reference can be either invoice_number or code.

Best Practices

  • Keep access_token secure.
  • Handle 401/403 by re-login flow.
  • Handle 422 as business/validation errors.
  • Do not assume payment_link is immediate in live mode.