Developer Portal

Everything you need to integrate our high-performance e-wallet microservice into your ecosystem.

Security & Authentication

Our API supports two modes of authentication for maximum flexibility.

1. Merchant API Key (Recommended for Orders)

Authorization: Bearer ex_pk_...

Find your unique key in the Merchants Dashboard.

2. Legacy Static Key (System-to-System)

Authorization: Bearer YOUR_STATIC_KEY

Reserved for administrative queries and legacy integrations.

API Endpoints

Post /api/wallets

Create Primary Wallet

Parameter	Type	Req	Description
user_id	Integer	YES	Internal ID of the user in your dashboard
currency	String(3)	YES	Standard ISO code (USD, EUR, GBP)

Post /api/orders

Generate Checkout Url

Parameter	Type	Req	Description
amount	Decimal	YES	Total order price (99.99)
currency	String(3)	YES	Matches the target wallet currency
customer_details	Object	YES	A JSON object containing customer info
└ name	String	YES	Customer first name
└ surname	String	YES	Customer last name
└ email	Email	YES	Valid email address
└ phone	String	YES	Customer contact number
└ address_line1	String	NO	Street address, P.O. box, etc.
└ city	String	NO	City, district, suburb, town, or village.
└ postal_code	String	NO	ZIP or postal code
└ country	String(2)	NO	ISO 3166-1 alpha-2 country code
redirect_url	URL	YES	User redirect destination after payment

Request JSON Example

                    {
                      "amount": 149.98,
                      "currency": "USD",
                      "redirect_url": "https://example.com/success",
                      "webhook_url": "https://your-api.com/webhooks",
                      "customer_details": {
                        "name": "Inga",
                        "surname": "Berzina",
                        "email": "inga@inbox.lv",
                        "phone": "+3712000000"
                      },
                      "items": [
                        {
                          "name": "Wallet Kit",
                          "price": 99.99,
                          "quantity": 1
                        }
                      ]
                    }

Success Response

                    {
                      "public_order_id": "EX-OAAMVPLML",
                      "status": "pending",
                      "checkout_url": "https://wallet.io/pay/EX-O..."
                    }

Get /api/orders/{id}/receipt

Download PDF Receipt

Generates a branded PDF receipt for a completed or pending order. Returns a binary file stream with Content-Type: application/pdf.

Post-Payment Webhooks

When an order is successfully paid, our system sends a Post request to your webhook_url. Use this to automate your internal fulfillment flow.

Field	Type	Description
event	String	Always `order.paid`
order_id	String	The unique EX-O... public ID
amount	String	Plain string amount "149.98"
signature	Hash	HMAC-SHA256 Security Signature

Webhook Payload

                    {
                      "event": "order.paid",
                      "order_id": "EX-SVUGY4KYEF",
                      "amount": "149.98",
                      "currency": "USD",
                      "status": "success",
                      "timestamp": 1777297199,
                      "signature": "ef2c8836c1...a8"
                    }

Security Verification

Verify each webhook by calculating the HMAC-SHA256 signature using your APP_KEY.

PHP Example

$expected = hash_hmac(
  'sha256',
  $order_id . $amount,
  $your_app_key
);

if ($expected === $request->signature) { ... }