SDK PHP

Per PHP è disponibile lo SDK ufficiale pubblicato come package Payrexx:

• Repository: github.com/payrexx/payrexx-php (https://github.com/payrexx/payrexx-php)
• Esempi: examples/ (https://github.com/payrexx/payrexx-php/tree/master/examples)

Il nome package resta Payrexx perché è il nome tecnico dello SDK. Su FlowAlp Pay configura l’API host white-label.

Installazione

# bash
composer require payrexx/payrexx

(Verifica il nome pacchetto Composer aggiornato nel repository ufficiale.)

Configurazione per FlowAlp Pay

# php
<?php
$instanceName = getenv('FLOWALP_PAY_INSTANCE'); // es. demo-shop
$apiSecret = getenv('FLOWALP_PAY_API_SECRET');

// API base white-label FlowAlp Pay
$payrexx = new \Payrexx\Payrexx(
    $instanceName,
    $apiSecret,
    '',
    'https://api.pay.flowalp.com'
);

Consulta il costruttore dello SDK nella versione che usi: alcuni release accettano esplicitamente l’API base URL. Se la tua versione non lo consente, verifica le opzioni di configurazione documentate nel repository e punta a api.pay.flowalp.com / v1.16.

Smoke test SignatureCheck

# php
$signatureCheck = new \Payrexx\Models\Request\SignatureCheck();
try {
    $response = $payrexx->getOne($signatureCheck);
    // credenziali OK
} catch (\Payrexx\PayrexxException $e) {
    // API Secret o instance non validi
}

Creare un Gateway

Usa i model Gateway dello SDK come negli esempi ufficiali, mantenendo amount in centesimi e currency ISO. Dopo la create, reindirizza il cliente all’URL di pagamento restituito e conferma via webhook.

Note

• Non commitare l’API Secret.
• Preferisci variabili d’ambiente / secret manager.
• In UI e log può comparire ancora la stringa “Payrexx”: è atteso.

Passaggi successivi

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