Skip to main content

Richiesta di pagamento

Il path parameter token è l'identificativo univoco risultante dalla creazione di una Payment Request

Creazione richiesta di pagamento

Permette di creare una richiesta di pagamento

[POST] /paymentRequest

Nella request abbiamo:

  • creditor: creditore della richiesta di pagamento
  • debtor: debitore della richiesta di pagamento
  • paymentReason: causale di pagamento
  • totalAmount: ammontare totale della richiesta di pagamento
  • availablePaymentPlans: piani di pagamento a disposizione
    • type: tipologia di piano (singolo o multiplo)
    • description: descrizione del piano di pagamento
    • installments: rate che compongono il piano di pagamento
      • description: descrizione della rata
      • dueDate: scadenza della singola rata
      • amount:  importo della rata
  • availablePaymentMethods: metodi di pagamento a disposizione
    • name: metodo di pagamento accettato
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento
  • ownerId: ownerId con identificativo TS Digital del creditore
  • transmitterId: transmitterId con identificativo TS Digital 
  • paymentDocuments: identificativi dei documenti che compongono la richiesta di pagamento
    • id: identificativo del documento 
    • type: tipo di documento

    • description: descrizione del documento

    • allowDownloadBeforePayment: booleano per inibire download prima che la richiesta sia completamente pagata (Default: true)
  • dueDate: data di scadenza della richiesta di pagamento

I constraints hanno una priorità. Se vengono definiti sia nella request che nelle preferenze, avranno precedenza quelli della richiesta puntuale. Il minimumAmount può non essere definito ma in tal caso assumerà valore 0 con valuta EUR

Se un piano di pagamento è definito come SINGLE_INSTALLMENT​ deve contenere una sola rata. Contrariamente se viene definito un MULTIPLE_INSTALLMENTS deve contenere almeno due rate

Tutte le valute dei vari importi devono coincidere

Per inviare automaticamente una mail al debitore, contenete il link di pagamento, bisogna fornire l'indirizzo email compilando l'attributo email del debtor

Nella response l'API ritorna:

  • id: identificativo univoco della richiesta di pagamento creata

  • token: identificativo da utilizzare nelle altre chiamate API per fare riferimento alla richiesta di pagamento in oggetto

  • url: link per visualizzare la richiesta di pagamento tramite UI Payment Container e successivamente effettuare dei pagamenti

 

Disabilitare richiesta di pagamento

Permette di disabilitare una richiesta di pagamento precedentemente creata

[PATCH] /paymentRequest/{token}/disable

Nella response l'API ritorna:

  • id: identificativo univoco della richiesta di pagamento disabilitata

  • token: identificativo token della richiesta di pagamento disabilitata

  • url: link disabilitato

 

Visualizzare una singola richiesta di pagamento [Profilo Pubblico]

Permette di visualizzare una richiesta di pagamento

[GET] /public/paymentRequest/{token}

Nella response l'API ritorna:

  • token: token della richiesta di pagamento
  • creditor: creditore della richiesta di pagamento
  • debtor: debitore della richiesta di pagamento
  • paymentReason: causale di pagamento
  • totalAmount: ammontare totale della richiesta di pagamento
  • availablePaymentPlans: piani di pagamento a disposizione
    • id: identificativo del piano di pagamento 
    • type: tipologia di piano (singolo o multiplo)
    • description: descrizione del piano di pagamento
    • installments: rate che compongono il piano di pagamento
      • id: identificativo della rata
      • description: descrizione della rata
      • dueDate: scadenza della singola rata
      • amount:  importo della rata
  • availablePaymentMethods: metodi di pagamento a disposizione
    • name: metodo di pagamento accettato
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento
  • ownerId: ownerId con identificativo TS Digital del creditore
  • transmitterId: transmitterId con identificativo TS Digital 
  • paymentDocuments: identificativi dei documenti che compongono la richiesta di pagamento
    • type: tipo di documento
    • description: descrizione del documento
    • previewUrl: link per preview documento
    • downloadUrl: link per download documento
  • dueDate: data di scadenza della richiesta di pagamento
  • status: stato generale in cui si trova la richiesta di pagamento
  • createdAt: data in cui è stata creata la richiesta
  • payments: pagamenti effettuati per la richiesta di pagamento
    • id: identificativo univoco del pagamento
    • amount: importo del pagamento
    • paymentMethodName: metodo di pagamento utilizzato
    • paymentPlanId: identificativo del piano di pagamento
    • installmentIds: rate del pagamento
    • status: stato del pagamento
    • link: link di pagamento

 

Visualizzare una singola richiesta di pagamento [Profilo Privato]

Permette di visualizzare una richiesta di pagamento

[GET] /paymentRequest/{token}

Nella response l'API ritorna:

  • token: token della richiesta di pagamento
  • creditor: creditore della richiesta di pagamento
  • debtor: debitore della richiesta di pagamento
  • paymentReason: causale di pagamento
  • totalAmount: ammontare totale della richiesta di pagamento
  • availablePaymentPlans: piani di pagamento a disposizione
    • id: identificativo del piano di pagamento 
    • type: tipologia di piano (singolo o multiplo)
    • description: descrizione del piano di pagamento
    • installments: rate che compongono il piano di pagamento
      • id: identificativo della rata
      • description: descrizione della rata
      • dueDate: scadenza della singola rata
      • amount:  importo della rata
  • availablePaymentMethods: metodi di pagamento a disposizione
    • name: metodo di pagamento accettato
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento
  • ownerId: ownerId con identificativo TS Digital del creditore
  • transmitterId: transmitterId con identificativo TS Digital 
  • paymentDocuments: identificativi dei documenti che compongono la richiesta di pagamento
    • type: tipo di documento
    • description: descrizione del documento
    • previewUrl: link per preview documento
    • downloadUrl: link per download documento
  • dueDate: data di scadenza della richiesta di pagamento
  • status: stato generale in cui si trova la richiesta di pagamento
  • createdAt: data in cui è stata creata la richiesta
  • enabled: stato della richiesta che indica se abilitata o disabilitata
  • payments: pagamenti effettuati per la richiesta di pagamento
    • id: identificativo univoco del pagamento
    • amount: importo del pagamento
    • paymentMethodName: metodo di pagamento utilizzato
    • paymentPlanId: identificativo del piano di pagamento
    • installmentIds: rate del pagamento
    • status: stato del pagamento
    • link: link di pagamento

 

Visualizzare richieste di pagamento

Permette di visualizzare una lista di richieste di pagamento

[GET] /paymentRequest

Parametri obbligatori:

  • ownerId: ownerId di cui si ha il permesso per operare e per cui si richiede la lista
  • timestamp: unix timestamp in millisecondi (esempio: 1643361440000)

Parametri opzionali:

  • size: numero di risultati per richiesta (default: 20)
  • continuationToken: token per richiedere il blocco successivo (restituito nella risposta)
  • sort: chiavi di sorting possibili -> createdAt
  • direction: desc | asc rispetto alla chiave di sorting

Nella response l'API ritorna:

  • content: lista di risultati con singola struttura identica alla richiesta singola [Profilo Privato]
  • continuationToken: token per richiedere altri risultati
  • hasNext: booleano che indica se ci sono altri risultati da visualizzare
  • size: massima dimensione dei risultati impostata nei filtri

 

Invio email

Permette l'invio forzato di una mail

[POST] /paymentRequest/{token}/sendMail

Nella request abbiamo:

  • email: indirizzo email a cui inviare la notifica (opzionale)

Nella response l'API non torna nulla se non lo status code

Il campo email è opzionale. Se nella creazione della richiesta di pagamento era stato impostato il campo email del debtor verrà preso quel valore per inviare nuovamente una mail. Impostando email in questa API, questo valore avrà precedenza rispetto a quello del debtor, ma non lo sostituirà. Per modificare l'email del debtor per tutta la richiesta di pagamento, procedere utilizzando l'API dedicata di modifica della richiesta di pagamento 

 

 

Back to top