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

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