Merchant API overview

La Merchant API di FlowAlp Pay è un’API REST per creare checkout (Gateway), gestire transazioni, subscription, invoice/paylink e altre risorse merchant.

Base URL

Versione stabile raccomandata:

# text
https://api.pay.flowalp.com/v1.16/

Pattern generale:

# text
https://api.pay.flowalp.com/v1.16/:object/:id?instance=<instance>

Il query parameter instance è obbligatorio. Per i dettagli vedi Instance name (/docs/flowalp-pay/getting-started/instance-name).

Autenticazione

• Consigliata: header X-API-KEY con l’API Secret
• Alternativa: parametro ApiSignature (HMAC-SHA256)

Guida: Autenticazione (/docs/flowalp-pay/api/authentication).

Smoke test ufficiale delle credenziali:

# text
GET /v1.16/SignatureCheck/?instance=<instance>

Formato request

JSON consigliato; è supportato anche application/x-www-form-urlencoded. Dettagli: Formato delle request (/docs/flowalp-pay/api/request-format).

Risorse tipiche

Risorsa | Uso
SignatureCheck | Verifica credenziali/firma
Gateway | Checkout di pagamento
Transaction | Stato e storico pagamenti
Subscription | Pagamenti ricorrenti
Invoice / Paylink | Link e fatture di pagamento
PaymentProvider | Elenco provider disponibili
Payout | Liquidazioni

Rate limit ed errori

• Rate limit (/docs/flowalp-pay/api/rate-limits): 600 request / 5 minuti (AWS WAF)
• Errori (/docs/flowalp-pay/api/errors)

Percorso consigliato

• Credenziali API (/docs/flowalp-pay/getting-started/api-credentials)
• Autenticazione (/docs/flowalp-pay/api/authentication)
• Prima richiesta API (/docs/flowalp-pay/getting-started/first-api-request)
• Creare un Gateway (/docs/flowalp-pay/api/gateway/create)
• Webhook (/docs/flowalp-pay/webhooks/configuration)