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
• dueDate: data di scadenza della richiesta di pagamento

I constraints sono obbligatori se non vengono definiti nelle Preferenze

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 richiesta 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