CreateCustomer

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > JamioPlug > JamioPlug StripeConnect > Customer >

CreateCustomer

Crea un Customer nella piattaforma di pagamento Stripe.

 

Metodo

PlugStripeConnect/CreateCustomer

 

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

 

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

customerData

Dato strutturato contenente i dati del Customer.

L'elenco dei parametri che possono essere inseriti è consultabile qui.

Se nel parametro customerData non sono definiti name, phone o email, essi verranno valorizzati a partire dalla risorsa identità di cui il parametro customerReference contiene il collegamento, nel seguente modo:

name, valorizzato a partire dalla proprietà Name dell'identità;

phone, valorizzato a partire dalla proprietà ServiceMobilePhoneNumber dell'identità;

email, valorizzato a partire dalla proprietà ServiceEmail dell'identità.

Dataset

Y

customerMetadata

Dato strutturato contenente dati aggiuntivi utili a valorizzare i metadati. 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

Output

 

Nome

Descrizione

Tipo

 

returnValue

Dato strutturato contenente le informazioni del Customer creato. Nei metadati viene sempre valorizzato il parametro customerReference con il collegamento all'identità Jamio che effettua il pagamento.

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.

 

 

Il metodo si comporta come segue:

Restituisce

Condizione

Errore

Se customerReference è già presente e associata al Recipient.

Errore

Se testMode è valorizzato e non è presente, per l'identità 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.

 

 

 

Autorizzazioni

Per eseguire il metodo è necessario possedere il permesso di Utilizzo sulla configurazione del Plug Stripe Connect.