Passo dopo passo

Passo dopo passo

PREREQUISITI: Ottieni le tue credenziali AP (da 5 a 10 minuti)

Già cliente? Hai dovuto ricevere una e-mail " Le tue credenziali API - inizia ora l'integrazione di SlimPay"
Non sei ancora cliente? YPuoi fare un test dell'integrazione di SlimPay sul tuo sito generando delle credenziali API aleatorie cliccando qui.

Nota

Questa guida non fornisce le basi dell’autenticazione API, né il formato delle richieste e delle risposte. Consulta questa sezione se non hai familiarità con questi concetti.

Tutti gli esempi di codice indicati nelle nostre guide sono scritti in PHP e si basano sul nostro HAPI client, sviluppato da Slimpay per semplificare il codice di interfacciamento con il nostro API. Per maggiori dettagli, visita la nostra pagina HTTP client.

Scarica qui il nostro client PHP ufficiale e decomprimi l'archivio (senza aggiungere delle cartelle supplementari) (5 mins)
Inserire la cartella estratta sul tuo server HTTP alla radice del tuo sito (5 mins)
Crea una nuova pagina PHP che apparirà quanto il tuo cliente effettuerà il pagamento (5 mins)

Esempio: La tua pagina possiede un bottone "Firma" o "Paga". Questa ti reindirizza verso questa nuova pagina "slimpay.php"

Inserisci la parte di codice seguente nella nuova pagina (10 mins)
Non dimenticare di aggiornare coi tuoi valori le credenziali nel codice qui di seguito

// Instructions: https://github.com/SlimPay/hapiclient-php
require_once 'vendor/autoload.php';

use \HapiClient\Http;
use \HapiClient\Hal;

// The HAPI Client
$hapiClient = new Http\HapiClient(
    'https://api.preprod.slimpay.com',
    '/',
    'https://api.slimpay.net/alps/v1',
    new Http\Auth\Oauth2BasicAuthentication(
        '/oauth/token',
        'yourAppName',
        'yourAppSecret'
    )
);

// The Relations Namespace
$relNs = 'https://api.slimpay.net/alps#';

// Follow create-orders
$rel = new Hal\CustomRel($relNs . 'create-orders');
$follow = new Http\Follow($rel, 'POST', null, new Http\JsonBody(
[
    'started' => true,
    'creditor' => [
        'reference' => 'yourCreditorReference'
    ],
    'subscriber' => [
        'reference' => 'theSubscriberReference'
    ],
    'items' => [
        [
            'type' => 'signMandate',
            'autoGenReference' => true,
            'mandate' => [
                'signatory' => [
                    'billingAddress' => [
                        'street1' => '27 rue des fleurs',
                        'street2' => 'Bat 2',
                        'city' => 'Paris',
                        'postalCode' => '75008',
                        'country' => 'FR'
                    ],
                    'honorificPrefix' => 'Mr',
                    'familyName' => 'Doe',
                    'givenName' => 'John',
                    'email' => 'change.me@slimpay.com',
                    'telephone' => '+33612345678'
                ],
                'standard' => 'SEPA'
            ]
        ]
    ]
]
));

try {
    $res = $hapiClient->sendFollow($follow);
    $url = $res->getLink('https://api.slimpay.net/alps#user-approval')->getHref();
    header('Location:' . $url);
    exit;
} catch (\HapiClient\Exception\HttpException $e) {
    $log = 'Error - ' . $e->getStatusCode() . ' ' . $e->getReasonPhrase() .
            ' - ' . $e->getResponseBody();
    echo $log;
}

// Instructions: https://github.com/SlimPay/hapiclient-php
require_once 'vendor/autoload.php';

use \HapiClient\Http;
use \HapiClient\Hal;

// The HAPI Client
$hapiClient = new Http\HapiClient(
    'https://api.preprod.slimpay.com',
    '/',
    'https://api.slimpay.net/alps/v1',
    new Http\Auth\Oauth2BasicAuthentication(
        '/oauth/token',
        'yourAppName',
        'yourAppSecret'
    )
);

// The Relations Namespace
$relNs = 'https://api.slimpay.net/alps#';

// Follow create-orders
$rel = new Hal\CustomRel($relNs . 'create-orders');
$follow = new Http\Follow($rel, 'POST', null, new Http\JsonBody(
[
    'started' => true,
    'creditor' => [
        'reference' => 'yourCreditorReference'
    ],
    'subscriber' => [
        'reference' => 'testphpclient01'
    ],
    'items' => [
        [
            'type' => 'signMandate',
            'autoGenReference' => true,
            'mandate' => [
                'signatory' => [
                    'billingAddress' => [
                        'street1' => '27 rue des fleurs',
                        'street2' => 'Bat 2',
                        'city' => 'Paris',
                        'postalCode' => '75008',
                        'country' => 'FR'
                    ],
                    'honorificPrefix' => 'Mr',
                    'familyName' => 'Doe',
                    'givenName' => 'John',
                    'email' => 'change.me@slimpay.com',
                    'telephone' => '+33612345678'
                ],
                'standard' => 'SEPA'
            ],
            [
                'type' => 'payment',
                'action' => 'create',
                'payin' =>[
                    'amount' => '29.99',
                    'scheme' => null,
                    'reference' => null,
                    'label' => 'First payment for your subscription',
                    'executionDate' => null
                ]
            ]
        ]
    ]
]
));

try {
    $res = $hapiClient->sendFollow($follow);
    $url = $res->getLink('https://api.slimpay.net/alps#user-approval')->getHref();
    header('Location:' . $url);
    exit;
} catch (\HapiClient\Exception\HttpException $e) {
    $log = 'Error - ' . $e->getStatusCode() . ' ' . $e->getReasonPhrase() .
            ' - ' . $e->getResponseBody();
    echo $log;
}

Prova i risultati effettuando un percorso sul tuo sito (5 mins)

Tappa Successiva

Ora che hai integrato SlimPay, devi sostituire i valori per difetto coi tuoi valori (esempio: nome, cognome, indirizzo del cliente).

Esempio:

'honorificPrefix' => $title,
     'familyName' => $family_name,
      'givenName' => $given_name,
          'email' => $client_email,

Assicurati che i seguenti campi siano sempre compilati, affinché SlimPay possa firmare un mandato (ed addebitare il tuo cliente):

'Creditor {reference}'
'Subscriber {reference}'
'Street1'
'City'
'PostalCode'
'Country'
'HonoricPrefix'
'FamilyName'
'GivenName'