Creare un abbonamento

Introduzione

Per attivare una dilazione o un pagamento è necessario prima inviare una richiesta di dilazione, quindi reindirizzare l'utente al gateway di pagamento con l'identificativo della dilazione ricevuto, passando un URL di ritorno. Il gateway reindirizzerà all'URL inviato per gestire il ritorno del pagamento.

Inviare una richiesta di abbonamento

Richiesta Http

POST https://api.jatapay.it/scrivi_abbonamento

Parametri

Parametro	Richiesto	Tipo	Descrizione
importo	Sì	int	L'importo dell'abbonamento espresso in centesimi di Euro
callback_url	Sì	string	Un URL Valido per il ritorno del pagamento
note	No	string	Delle note descrittive per il pagamento
descrizione_prodotto	Sì	string	La descrizione del prodotto
cliente	Sì	string	Utilizzare il valore 'open'

shell

curl "https://api.jatapay.it/scrivi_abbonamento" \
 -H "Authorization: Bearer IL_TOKEN_DI_ACCESSO" \
 -d = '{}'

PHP

$dati_abbonamento = array(            
           'importo' => 2000, //Importo in centesimi di euro
           'callback_url' => 'https://e-commerce.example.com/callback_url',
           'note' => 'Dilazione per motivo esempio',
           'cliente' => 'open',
           'descrizione_prodotto' => 'Descrizione del prodotto'
         );

   $url = curl_init("https://api.jatapay.it/scrivi_abbonamento");
   $authorization = "Authorization: Bearer ".$token;
   curl_setopt($url, CURLOPT_CUSTOMREQUEST, "POST");
   curl_setopt($url, CURLOPT_POSTFIELDS, json_encode($dati_abbonamento));
   curl_setopt($url, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($url, CURLOPT_HTTPHEADER, array(
     'Content-Type: application/json',
     'Content-Length: ' . strlen(json_encode($dati_abbonamento)),
     $authorization
   ));

   $result = curl_exec($url);

   $api_response = json_decode($result);

   curl_close($url);

Python

import requests
import json

dati_abbonamento = {
    'importo': 2000,  # Importo in centesimi di euro
    'callback_url': 'https://e-commerce.example.com/callback_url',
    'note': 'Dilazione per motivo esempio',
    'cliente': 'open',
    'descrizione_prodotto': 'Descrizione del prodotto'
}

url = "https://api.jatapay.it/scrivi_abbonamento"
token = "your_access_token"  #  il tuo token
authorization = "Bearer " + token

headers = {
    'Content-Type': 'application/json',
    'Authorization': authorization
}

response = requests.post(url, data=json.dumps(dati_abbonamento), headers=headers)

api_response = response.json()

print(api_response)

Il comando ritornerà un JSON con questa struttura:

{
  'id_abbonamento': '65b278baa103dca4496d968e'
}

warning

La richiesta deve avere l'header Content-Type: application/json e includere il parametro nel corpo del JSON e l'header Authorization: Bearer token

Reindirizzare l'utente al gateway di pagamento

Una volta ottenuto l'id dell'abbonamento è necessario reindirizzare l'utente al gateway di pagamento all'url:

https://dashboard.jatapay.com/gateway/ID_ABBONAMENTO

warning

Sostituire ID_DELLA_DILAZIONE con l'id ottenuto in precedenza

L'utente completerà il processo di pagamento e sarà reindirizzato all'url passato in precedenza.

Gestire il ritorno del pagamento

In qualunque momento sarà possibile recuperare le informazioni sull'abbonamento per il controllo dell'avvenuta attivazione dello stesso.

GET https://api.jatapay.it/entity/subscriptions/ID_ABBONAMENTO

warning

Sostituire ID_ABBONAMENTO con l'id ottenuto in precedenza

shell

   curl "https://api.jatapay.it/entity/subscriptions/ID_ABBONAMENTO" \
 -H "Authorization: Bearer IL_TOKEN_DI_ACCESSO" \

PHP

$urlstring = "https://api.jatapay.it/entity/subscriptions/".$_GET['id_abbonamento'];
   $url = curl_init($urlstring);
   $authorization = "Authorization: Bearer ".$token;
   curl_setopt($url, CURLOPT_CUSTOMREQUEST, "GET");
   curl_setopt($url, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($url, CURLOPT_HTTPHEADER, array(
     $authorization
   ));

   $result = curl_exec($url);
   curl_close($url);
   $api_response = json_decode($result);

Python

import requests
import cgi

form = cgi.FieldStorage()

id_abbonamento = form.getValue('id_abbonamento')
token = 'IL_TUO_TOKEN'
headers = {"Authorization": "Bearer " + token}
url = 'https://api.jatapay.it/entity/subscriptions/' + id_abbonamento
response = requests.get(url,headers=headers)
if response.status_code == 200:
  response = response.json()
else:
  print('Error, ' + str(response.status_code))

Il comando ritornerà un JSON con questa struttura:

{
  "_id": "65b279426d2f219d702a7f69", 
  "callback_url": "https://e-commerce.example.com/callback_url", 
  "client": "JataPay", 
  "cliente": "open", 
  "data_inizio": "Thu, 25 Jan 2024 15:07:46 GMT", 
  "data_inserimento": "Thu, 25 Jan 2024 15:07:46 GMT", 
  "esercente': '60c5d53a052bf51a1ca1e1b5", 
  "importo": 2000, 
  "note": "Dilazione per motivo esempio", 
  "numero": 170, 
  "numero_txt": "170", 
  "stato": "iniziata", 
  "user": "60c5d53a052bf51a1ca1e1b5"
}