Format des requêtes

URL

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

Elemento | Posizione | Obbligatorio | Note
object | path | sì | Es. `Gateway`, `Transaction`, `SignatureCheck`
id | path | no* | Per GET/PUT/DELETE su una singola entità
instance | query | sì | Instance name del merchant

\* obbligatorio quando operi su una singola entità.

Per le request POST, tutti i parametri tranne instance vanno nel body.

Content-Type supportati

Formato | Nota
`application/json` | **Consigliato**
`application/x-www-form-urlencoded` | Encoding RFC 3986; spazi come `%20` nel payload

Autenticazione nella request

• Header X-API-KEY: <api-secret> (consigliato), oppure
• Parametro ApiSignature calcolato come HMAC-SHA256

Vedi Autenticazione (/docs/flowalp-pay/api/authentication).

Esempio JSON

# bash
curl --request POST \
  --url "https://api.pay.flowalp.com/v1.16/Gateway/?instance=demo-shop" \
  --header "X-API-KEY: <api-secret>" \
  --header "Content-Type: application/json" \
  --data '{"amount":2500,"currency":"CHF"}'

Errori tipici di formato

• instance messo nel body invece che in query
• Content-Type mancante o non allineato al body
• Importi inviati come decimali invece che centesimi interi
• Encoding della query string diverso da quello atteso per ApiSignature

Passaggi successivi

• Creare un Gateway (/docs/flowalp-pay/api/gateway/create)
• Errori (/docs/flowalp-pay/api/errors)