Your first payment.

Go from a signed request to a confirmed local payment. The complete request example is alongside this guide.

Before you begin

Ask the Axiron team for your merchant ID, Bearer token, secret key and enabled payment methods. Confirm the environment and approved testing procedure before sending requests.

Prepare your server
Keep your token and signing key in server-side environment variables. Requests use JSON and are authenticated with a Bearer token and HMAC-SHA256 signature.
Understand authentication →
Create the payment
Provide merchantId, a unique orderId, amount, currency and an enabled method. Include callbackUri to receive status changes.
See all request parameters →
Present the checkout
Store the returned payment_id. Redirect the customer to rediUrl for the hosted checkout, or show the returned transfer details in your own interface. Respect expired_at.
Confirm the result
Verify callback signatures and read result.state. Only completed represents a successful payin. Compare the settled amount with init_amount before reconciling.
Implement the callback →

A created payment is not a completed payment.

An HTTP 200 from creation means the payment was created. Wait for its final payment state before crediting the customer.

Request example

POST/v2/payments

# Step 1: build compact JSON body (no spaces — required for valid signature)
BODY='{"merchantId":"MERCHANT_ID","orderId":"uuid","amount":7169.13,"currency":"ARS","method":"qr","callbackUri":"https://example.com/callback","cuit":"user_42","payer_name":"Juan Perez"}'

# Step 2: compute HMAC-SHA256 signature
SIG=$(echo -n "$BODY" | openssl dgst -sha256 -hmac "YOUR_SECRET_KEY" | awk '{print $2}')

# Step 3: send request
curl -X POST https://axiron.io/v2/payments \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "signature: $SIG" \
  -H "Content-Type: application/json" \
  -d "$BODY"

Response

{
  "status": true,
  "result": {
    "id": "2fbc1d6f-3ad3-46a1-aa0f-7f6eb6f363ac",
    "order_id": "2fbc1d6f-3ad3-46a1-aa0f-7f6eb",
    "payment_id": "477374d1-e7f5-4ab7-b3b1-e86",
    "state": "pending",
    "address": "000007650000001723",
    "image": "https://axiron.io/api/v1/uploads/qr-codes/cards/CARD001513/qr_process.png",
    "bank": "Personal Pay",
    "bankName": "Personal Pay",
    "country": 1,
    "recipient": "Milagros Ayelen",
    "rate": "1444.86",
    "amount": "7169.13",
    "init_amount": "7169.13",
    "message": null,
    "commission": "3.00",
    "usdt_amount": 4.961816369752087,
    "expired_at": "2026-03-13T20:35:20.057Z",
    "method": "qr",
    "data": "00020101021127730018ar.com.personalpay01478fZ81SRv7rCyACP8tLXJXW-e9q7Us5pA2cXLoj6M4kmQB-05204739953",
    "rediUrl": "https://axiron.io/checkout/477374d1-e7f5-4ab7-b3b1-e86"
  }
}

Examples use placeholder credentials. Send signed requests from your server.

Your first payment.

Prepare your server

Create the payment

Present the checkout

Confirm the result