CreateSubscription

<< Fare clic per visualizzazione il sommario >>

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

CreateSubscription

Imposta pagamenti ricorrenti da parte di una CustomerReference di Jamio verso un RecipentReference.

 

Metodo

PlugStripeConnect/CreateSubscription

 

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

 

subscriptionData

Dato strutturato contenente le proprietà della Subscription.

L'elenco dei parametri che possono essere inseriti è consultabile qui. Tra questi sono obbligatori i parametri customer e items: customer è ricavato in automatico dalla customerReference e items deve contenere almeno un Price, ad esempio "items[0]price".

Dataset

 

subscriptionMetadata

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

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

paymentMethodReference

Collegamento al PaymentMethod. Esso deve essere attivo per la recipientReference.

Il parametro non è obbligatorio, in quanto può essere specificato nel parametro subscriptionData, nel campo default_payment_method. Nel caso siano entrambi valorizzati, esso viene sostituito con il valore specificato in questo parametro.

Reference

Y

Output

 

Nome

Descrizione

Tipo

 

returnValue

Dato strutturato contenente la Subscription creata.

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 subscriptionData, 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 il parametro customerReference non è associato al Recipient, cui fa riferimento il parametro recipientReference.

Errore

Se il parametro customerReference è associato al Recipient, cui fa riferimento il parametro recipientReference, ma il Customer non è presente in Stripe.

Errore

Se il parametro subscriptionData contiene il campo default_payment_method, ma non viene valorizzato o il PaymentMethod non è attivo per il Customer su quel determinato Recipient.

 

Autorizzazioni

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