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