Dettaglio dilazione

Ritorna i dati della dilazione indicata: importo, numero di rate, stato, cadenza, riferimenti a cliente ed esercente, coordinate di addebito e contratto collegato. L'identificativo si ottiene dall'endpoint Elenco dilazioni.

Richiesta Http

GET https://api.jatapay.it/dilazioni/ID_DILAZIONE

Parametri di percorso

Parametro	Richiesto	Tipo	Descrizione
id_dilazione	Sì	string	Identificativo della dilazione (_id restituito dall'elenco)

shell

curl -X GET "https://api.jatapay.it/dilazioni/ID_DILAZIONE" \
  -H "Authorization: Bearer IL_TOKEN_DI_ACCESSO"

PHP

$token = 'IL_TOKEN_DI_ACCESSO';

$url = curl_init("https://api.jatapay.it/dilazioni/ID_DILAZIONE");
$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

token = "IL_TOKEN_DI_ACCESSO"

headers = {
    "Authorization": "Bearer " + token
}

response = requests.get("https://api.jatapay.it/dilazioni/ID_DILAZIONE", headers=headers)

print(response.status_code)
print(response.json())

Node.js

const token = 'IL_TOKEN_DI_ACCESSO';

const response = await fetch('https://api.jatapay.it/dilazioni/ID_DILAZIONE', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

console.log(response.status, await response.json());

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	const token = "IL_TOKEN_DI_ACCESSO"

	req, err := http.NewRequest("GET", "https://api.jatapay.it/dilazioni/ID_DILAZIONE", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+token)

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}

	fmt.Println(res.StatusCode, string(data))
}

.NET

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        const string token = "IL_TOKEN_DI_ACCESSO";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

        var response = await client.GetAsync("https://api.jatapay.it/dilazioni/ID_DILAZIONE");

        Console.WriteLine((int)response.StatusCode);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String token = "IL_TOKEN_DI_ACCESSO";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.jatapay.it/dilazioni/ID_DILAZIONE"))
                .header("Authorization", "Bearer " + token)
                .GET()
                .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
                .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Risposta

La risposta è l'oggetto della dilazione, con lo schema Dilazione e tutti i campi del modello dati. Il campo pagamenti elenca i pagamenti figli della dilazione.

{
  "_id": "6ad9e1811d7bc659f6125db0",
  "importo": 44400,
  "rate": 12,
  "data_inizio": "2026-10-22T12:12",
  "data_fine": "2027-09-01T03:00",
  "stato": "attiva",
  "note": "",
  "tipo": "credit",
  "stripe": {},
  "ip_address": "18.197.173.184",
  "descrizione_prodotto": "",
  "multisafepay": {},
  "vendor": "stripe",
  "callback_url": "",
  "rate_differenziate": false,
  "data_inserimento": "2026-10-22T10:12",
  "date_differenziate": false,
  "numero": 3146,
  "numero_txt": "3146",
  "payment_method": "sdd",
  "base": 0,
  "cliente": "6a218ca738c301f9262b9017",
  "esercente": "6a55ecdfb180394de3e29aa5",
  "no_billing": true,
  "metadata": "",
  "consenso_debit": true,
  "link_to_pay": false,
  "cadenza": {
    "valore": 1,
    "periodo": "month"
  },
  "contratto": {
    "pdf": "6ad9e1821d7bc659f6125dbd"
  },
  "iban": "6ad9e188ee0a0643973ffca4",
  "pagamenti": [
    {
      "_id": "6ae07f601d7bc659f6125dcc",
      "tipo": "rata_dilazione",
      "importo": 3700,
      "dilazione": "6ad9e1811d7bc659f6125db0",
      "numero": 1,
      "numero_txt": "1",
      "totale_rate": 12,
      "data_pagamento": "",
      "stato": "unpaid",
      "payment_method": "sdd",
      "cliente": "6a218ca738c301f9262b9017",
      "esercente": "6a55ecdfb180394de3e29aa5"
    }
  ]
}

Errori

Codice	Descrizione
400	Richiesta non valida, parametri mancanti o non coerenti
401	Token mancante, scaduto o non valido
403	Ruolo non abilitato all'operazione
500	Errore interno del server

Il corpo della risposta di errore contiene sempre error_code (il codice simbolico dell'errore, ad esempio bad_request, oppure il codice HTTP corrispondente) e error_message con il messaggio descrittivo:

{
  "error_code": "bad_request",
  "error_message": "Messaggio di errore"
}

warning

La richiesta deve avere l'header Authorization: Bearer <token> e, quando è presente un corpo, l'header Content-Type: application/json.