<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > JamioPlug > JamioPlug StripeConnect > Invoice > CreateInvoice |
Crea un'Invoice nella piattaforma di pagamento Stripe da parte di una customerReference verso un recipentReference.
Metodo
PlugStripeConnect/CreateInvoice
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
serverAddress |
Indirizzo server da un Dominio esterno (per il Dominio della sessione corrente, utilizzare nullo o vuoto). |
String |
Y |
token |
Token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto). |
String |
Y |
customerReference |
Collegamento all'identità che effettua il pagamento. |
Reference |
|
recipientReference |
Collegamento all'identità o elemento organizzativo che riceve i pagamenti. |
Reference |
|
invoiceData |
Dato strutturato contenente i dati dell'Invoice. L'elenco dei parametri che possono essere inseriti è consultabile qui. Tra questi sono obbligatori i parametri customer, default_payment_method. Il parametro customer è ricavato in automatico dalla customerReference. Il parametro default_payment_method è ricavato, in ordine di priorità, in automatico: •dal valore del paymentMethodReference; •dal valore del default_payment_method dato in input con il dato strutturato del parametro invoiceData. •dal valore del metodo di pagamento di default del Customer se non valorizzato o non specificato nel paymentMethodReference. Nel caso i parametri customer e default_payment_method siano valorizzati sia in invoiceData che nei rispettivi parametri customerReference e paymentMethodReference, essi vengono sostituiti con il valore specificato in customerReference e paymentMethodReference. |
Dataset |
Y |
invoiceMetadata |
Dato strutturato contenente dati aggiuntivi utili a valorizzare i metadati dell'Invoice. Non può contenere dati annidati o liste. Può contenere massimo 50 campi, con nomi di campo lunghi fino a 40 caratteri e valori di tipo stringa lunghi fino a 500 caratteri. |
Dataset |
Y |
paymentMethodReference |
Collegamento al PaymentMethod. Esso deve essere attivo per la recipientReference. Il parametro non è obbligatorio, in quanto può essere specificato nel parametro invoiceData, nel campo default_payment_method. Nel caso siano entrambi valorizzati, esso viene sostituito con il valore specificato in questo parametro. |
Reference |
Y |
testMode |
True se è richiesta l'esecuzione del metodo in modalità test di Stripe. Se non specificato, viene effettuata l'esecuzione del metodo in modalità live di Stripe. La modalità testMode indicata deve essere ammessa dalla configurazione. |
Boolean |
Y |
Output |
|
||
Nome |
Descrizione |
Tipo |
|
returnValue |
Dato strutturato contenente le informazioni dell'Invoice creata in Stripe ed in stato "draft". |
Dataset |
|
Commenti
Il Customer, cui fa riferimento il parametro customerReference, deve essere associato al Recipient, cui fa riferimento il parametro recipientReference, nella modalità test prevista.
Si sconsiglia di specificare l'Id del Customer nel parametro inovoiceData, nel campo customer, poiché il metodo in automatico lo valorizza con l'Id ricavato dal collegamento specificato nel parametro customerReference. Nel caso siano entrambi valorizzati, prevale il parametro customerReference.
Il metodo si comporta come segue:
Restituisce |
Condizione |
Errore |
Se testMode è valorizzato e non è presente, per l'identità o l'elemento organizzativo a cui fa riferimento RecipientReference, una configurazione che permette la chiamata nella modalità TestMode indicata. |
Errore |
Se customerReference non è associata al Recipient cui fa riferimento il parametro recipientReference. |
Errore |
Se customerReference è associata al Recipient cui fa riferimento il parametro recipientReference. ma il Customer non è presente in Stripe. |
Errore |
Se il parametro invoiceData contiene il campo default_payment_method, ma non viene valorizzato o riporta un PaymentMethod non presente nel Recipient. |
Errore |
Se il parametro paymentMethodReference riporta un collegamento ad un PaymentMethod non attivo nel Recipient. |
Autorizzazioni
Per eseguire il metodo è necessario possedere il permesso di Utilizzo sulla configurazione del Plug Stripe Connect.