animica-payments

ANM balances and merchant payments

Read a balance (no auth)

# Node RPC (result = hex base units; 1 ANM = 10^9 base units)
curl -s -X POST https://rpc.animica.org/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"state.getBalance","params":{"address":"anim1zqp6zhtjsvse38vlkekdh7d44k2rmvctvkc8n6m55dhh5n8x6rpqavgztza8r"}}'

# Explorer (balance + tx history)
curl -s https://explorer.animica.org/api/address/anim1zqp6zhtjsvse38vlkekdh7d44k2rmvctvkc8n6m55dhh5n8x6rpqavgztza8r

Merchant payments — pay.animica.dev

Base URL https://pay.animica.dev. Fee: 2.00% per successful payment. Docs: https://pay.animica.dev/docs.

Wire rules (verified against the live API):

• Auth: Authorization: Bearer ask_live_… / ask_test_… (secret key). Publishable keys (apk_…) are refused on the API and must never leave the browser context; secret keys must never appear in a browser.
• Amounts are decimal strings, never JSON numbers. nANM: 1 ANM = 1,000,000,000 nANM. ANM amounts allow ≤ 9 decimals; fiat ≤ 2 decimals. A JSON number is rejected with amount_must_be_string.
• Send Idempotency-Key on every write (use your order id). Same key + same body replays the original response; same key + different body → 409 idempotency_key_reused — never mint a fresh key on 409.
• Errors share one envelope: {"error":{"type","code","message","request_id"}}. Quote request_id in support requests. Unauthorized → 401 unauthorized.

Create a payment intent

curl -s -X POST https://pay.animica.dev/api/v1/payment-intents \
  -H "Authorization: Bearer $ANIMICA_PAY_SECRET_KEY" \
  -H "Idempotency-Key: order_19482" \
  -H 'Content-Type: application/json' \
  -d '{"amount":"49.99","currency":"USD","merchant_order_id":"19482",
       "description":"Order #19482",
       "success_url":"https://shop.example/received/19482",
       "cancel_url":"https://shop.example/checkout"}'
# 201 -> {"object":"payment_intent","id":"pay_…","status":"AWAITING_PAYMENT",
#         "anm_amount":"…","merchant_amount":"…","protocol_fee":"…","protocol_fee_bps":200,
#         "payment_address":"anim1…","checkout_url":"https://pay.animica.dev/c/pay_…",
#         "required_confirmations":12,"expires_at":"…"}