Champ
Type
Description
_id
L'identifiant que nous attribuons à cet abonnement. Omettez-le lors de la création d'un abonnement et envoyez-le lors de la mise à jour d'un abonnement.
externalId
Votre propre identifiant pour cet abonnement, provenant de votre logiciel. Envoyez à nouveau le même externalId pour mettre à jour cet abonnement au lieu d'en ajouter un nouveau. Nous faisons la correspondance sur cette valeur, mais nous n'empêchons pas les doublons; gardez-la donc unique au sein du site.
description
Une brève description des produits/services sur l'abonnement utilisé dans la demande de paiement affichée au client.
amount
Le montant à facturer pour chaque période de facturation. Il s'agit d'un nombre entier de cents, donc 1035 signifie $10.35.
frequency
La fréquence de facturation. Bi-Weekly facture tous les 14 jours et Quarterly tous les 3 mois. Semi-Monthly facture deux fois par mois, le jour de début et le jour du mois situé à 14 jours d'écart : un début le 1er facture le 1er et le 15, et un début le 20 facture le 20 et le 6. Semi-Annually facture tous les 6 mois le jour de début. Un abonnement Monthly commencé du 29 au 31 est facturé le dernier jour d'un mois plus court et reste ensuite à ce jour.
One of Daily, Weekly, Bi-Weekly, Semi-Monthly, Monthly, Quarterly, Semi-Annually, Yearly
frequencyUnits
Nombre d'unités de fréquence entre les versements. Ex. : frequency = Yearly et frequencyUnits = 2 signifie tous les 2 ans. S'applique uniquement à Daily, Weekly, Monthly et Yearly, et est ignoré pour les autres fréquences.
customer
Une référence au dossier du client.
startDate
La date de début de l'abonnement. Si laissée vide, elle sera définie lorsque le client confirme son mode de paiement. Une date sans heure. Une heure ou un fuseau horaire envoyé avec elle est ignoré, et non converti, de sorte que la date reste telle qu'écrite. Format = YYYY-MM-DD
numberOfPayments
Le nombre de versements à effectuer. Si laissé vide, l'abonnement se poursuit indéfiniment ou jusqu'à ce qu'il soit fermé manuellement.
webhookUrl
L'URL à laquelle envoyer une requête POST lorsque certaines actions sont effectuées sur l'abonnement. Un webhook est envoyé lorsqu'un paiement atteint un nouvel état, et lorsqu'un message texte, un courriel ou un message WhatsApp est envoyé, livré, lu, retardé ou échoue, ou lorsque le client clique sur le lien de paiement.
attachmentRefs
Une liste de pièces jointes.
send
À qui Abonnement est envoyé, par canal. Un canal que vous indiquez est utilisé tel quel, et une liste vide ([]) désactive ce canal. Un canal que vous omettez conserve les destinataires que Abonnement a déjà, ou est rempli à partir des contacts du client, selon le contrôle des notifications du client, lorsqu'il n'en a pas encore. Lors d'une création, omettez send pour laisser les contacts du client décider de chaque canal lors de l'envoi de Abonnement. Lors d'une mise à jour, l'omettre conserve les destinataires déjà choisis. Une lecture renvoie send.to à null tant que les destinataires n'ont pas été choisis. billTo.emails et billTo.sms demeurent le remplacement pour déterminer qui reçoit ces canaux, mais ne réactivent jamais un canal que send a désactivé. Chaque Facture générée par l'abonnement est envoyée à ces destinataires, tels qu'ils sont au moment où cette Facture est générée; un changement s'applique donc aux Factures générées par la suite.
billToCustomer
Le client qui reçoit et paie la facture, lorsqu'il ne s'agit pas de customer.
billTo
Remplacements facultatifs pour la section Facturer à de la facture. Si billToCustomer est fourni, cet objet sera fusionné avec les renseignements du client et peut servir à remplacer des champs précis. Si billToCustomer n'est pas fourni, les champs de cet objet seront utilisés comme renseignements de facturation sur la facture.
soldTo
Options facultatives pour la section Expédié à / Client de la facture.
deleted
Ce drapeau représente si l'enregistrement est supprimé et n'est plus disponible pour être utilisé.