Recuperare ed elencare i Paylink

Leggi un singolo Paylink a partire dal suo ID per esaminarne la configurazione o per verificare che una notifica di pagamento gli appartenga davvero. Nella Merchant API la risorsa Paylink si chiama Invoice.

Per le nuove integrazioni usa la versione API v1.16; v1.14 e v1.15 restano supportate. Autenticati con l'header X-API-KEY — vedi Autenticazione.

Request#

Path parameter#

Query parameter#

Esempio di request#

curl --request GET \
  --url "https://api.pay.flowalp.com/v1.16/Invoice/57/?instance=${FLOWALP_PAY_INSTANCE}" \
  --header "X-API-KEY: ${FLOWALP_PAY_API_SECRET}"

<?php
use FlowAlpPay\FlowAlpPay;
use FlowAlpPay\Models\Request\Paylink;

$client = new FlowAlpPay(
    getenv('FLOWALP_PAY_INSTANCE'),
    getenv('FLOWALP_PAY_API_SECRET'),
    FlowAlpPay::DEFAULT_COMMUNICATION_HANDLER,
    'pay.flowalp.com',
    '1.16'
);

$paylink = new Paylink();
$paylink->setId(57);

$response = $client->getOne($paylink);

$link        = $response->getLink();
$referenceId = $response->getReferenceId();

Response#

Il Paylink viene restituito nell'envelope di successo. Uno schema ricorrente: quando un webhook annuncia un pagamento, chiama questo endpoint con l'ID salvato e confronta referenceId e amount con i tuoi dati prima di segnare la fattura come pagata.

{
  "status": "success",
  "data": [
    {
      "id": 57,
      "hash": "f7d1b2e94c3a48d2a5efb6c17d0a9c31",
      "referenceId": "INV-2026-0042",
      "link": "https://demo-shop.pay.flowalp.com/?payment=f7d1b2e94c3a48d2a5efb6c17d0a9c31",
      "title": "Invoice INV-2026-0042",
      "description": "Consulting services, June 2026",
      "purpose": "Invoice INV-2026-0042",
      "amount": 8925,
      "currency": "CHF",
      "createdAt": "2026-07-30 11:52:08"
    }
  ]
}

Elencare i Paylink#

Le versioni API da v1.14 a v1.16 non documentano una query di elenco che restituisca tutti i Paylink di una instance, e per questa risorsa non sono disponibili parametri di paginazione. Recupera i Paylink singolarmente per ID e salva la corrispondenza tra id, hash e referenceId nel tuo database al momento della creazione.

Errori#

Le response di errore usano l'envelope {"status": "error", "message": "..."} — vedi Errori e Rate limit.