Comment configurer et utiliser les webhooks "Factures"

Field

Type

Description

Example

event_type

string

Type d’événement

"invoice-finalize"

date

number (timestamp)

Horodatage du déclenchement de l’événement

1762246989

data

Object

Détails concernant l’événement et la facture (voir ci-dessous)

-

data.date

Date de l’événement (UTC)

"2025-11-04T09:03:11.653072Z"

data.object.id

string (uuid)

Identifiant unique de la facture

"923e2c97-8228-4d42-8a44-1783c70c50a1"

data.object.status

string

Statut de la facture (open, paid, refunded, voided)

data.object.date_created

string (date-time)

Date de création de la facture (UTC)

"2025-11-04T09:03:06.515219Z"

data.object.date_issued

string (date-time)

Date d’émission de la facture (UTC)

"2025-11-04T09:03:08.225042Z"

data.object.date_due

string (date-time)

Date d’échéance du paiement (UTC)

"2025-11-04T09:03:07.292000Z"

data.object.date_cancelled

string (date-time) | null

Date d’annulation (si annulée)

null

data.object.currency

string

Devise (ISO 4217 code).

"eur"

data.object.total

number (cents)

Montant total de la facture (plus petite unité monétaire)

36665

data.object.amount_due

number (cents)

Montant restant dû

36665

data.object.amount_paid

number (cents)

Montant déjà payé

0

data.object.company

object

Société émettrice

{ ... }

data.object.company.id

number

Identifiant unique de la société

85329

data.object.company.name

string

Nom de la société

"SaudeViva Portugal"

data.object.company.country

string

Code pays

"PT"

data.object.company.city

string

Ville

"Lisbon"

data.object.company.address

string

Adresse

"Rua do Ouro 115"

data.object.company.postal_code

string

Code postal/ZIP

"1100-062"

data.object.customer

object | null

Client (Peut être null pour des factures anonymes issues du Point de Vente.)

{ ... }

data.object.customer.id

number

Identifiant unique du client/membre

7644312

data.object.customer.type

string

Type de client (toujours individual)

"individual"

data.object.customer.name

string

Nom complet

"Maria Oliveira"

data.object.customer.first_name

string

Prénom

"Maria"

data.object.customer.last_name

string

Nom

"Oliveira"

data.object.customer.email

string

Email de contact

"maria.oliveira77@example.com"

data.object.customer.phone

string

Numéro de téléphone

"+351 912 345 678"

data.object.customer.official_document_id

string

Identifiant officiel (ex : NIF)

"PT-19847765"

data.object.customer.address

object

Adresse du client

{ ... }

data.object.customer.address.line1

string

Adresse principale

"Avenida da Liberdade 202"

data.object.customer.address.line2

string (optional)

Complément d’adresse

"4º Esq."

data.object.customer.address.city

string

Ville

"Lisbon"

data.object.customer.address.postal_code

string

Code Postal

"1250-147"

data.object.customer.address.state

string

Région

"Lisboa"

data.object.customer.address.country

string

Code pays

"PT"

data.object.line_items

object

Lignes de facture

{ ... }

data.object.line_items.line_count

number

Nombre de lignes

6

data.object.line_items.data

array<object>

Liste des lignes de facture

[{ ... }, { ... }]

data.object.line_items.data[].id

number

Identifiant unique de la ligne

2153

data.object.line_items.data[].description

string

Nom/description du produit ou service

"£100 General Gift Voucher"

data.object.line_items.data[].quantity

number

Quantité achetée

1

data.object.line_items.data[].tax_included_unit_amount

number (cents)

Prix unitaire TTC

10000

data.object.line_items.data[].tax_included_amount

number (cents)

Prix total TTC avant remise

10000

data.object.line_items.data[].voucher_applied

number (cents)

Remise appliquée

0

data.object.line_items.data[].line_total

number (cents)

Montant final après remise

10000

data.object.line_items.data[].tax_breakdown

object

Détail des taxes

{ ... }

data.object.line_items.data[].tax_breakdown.rate

number (%)

Taux de TVA (ex : 20 = 20 %)

0

data.object.line_items.data[].tax_breakdown.total_tax

number (cents)

Montant total de taxe inclus

0

data.object.line_items.data[].tax_breakdown.unit_tax

number (cents)

Taxe incluse par unité

0

data.object.line_items.data[].item_type

string

Type d’élément bsport (shop-product, pass, private_pass, consumer_giftcard, refund)

"consumer_giftcard"

data.object.invoice_pdf

string (url)

Lien vers le PDF de la facture

"https://assets.staging.bsport.io/.../invoice-24092226.pdf"

data.object.receipt_pdf

string (url) | null

Lien vers le reçu de paiement (le cas échéant)

null

data.object.invoice_type

number

Type de facture : 0=normale, 1=annulation (reverse), 2=avoir, 3=migration

0

data.object.source_invoice_id

string (uuid) | null

UUID de la facture originale annulée via celle-ci (le cas échéant)

null