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
• customizationOptions: opzioni di customizzazione
  • logo: logo personalizzato
  • theme: tema personalizzato
• 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 customizationOptions: opzioni di customizzazione

logo: logo personalizzato theme: tema personalizzato 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 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 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 creare 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
• customizationOptions: opzioni di customizzazione
  • logo: logo personalizzato
  • theme: tema personalizzato
• 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
• 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