Attributs
Cet objet représente un lien de paiement qui peut être associé à un client.
id chaîne
L'identifiant unique du client (MAX 64 ; MIN 36).
Exemple: 8546df3a-b83e-4bb5-a4b3-57aa6385924f
account_id chaîne
L'identifiant unique du compte (MAX 64 ; MIN 36).
Exemple: 9104911d-5df9-429e-8488-ad41abea1a4b
description chaîne
Description du lien de paiement (MAX 255 ; MIN 3).
Exemple : Paiement au titre du marché
country enum
Pays où la transaction doit être traitée (MAX 2 ; MIN 2 ; ISO 3166-1).
Valeurs possibles : Voir la référence du pays.
status enum
Statut du lien de paiement (MAX 255 ; MIN 3) (CREATED, UTILISÉ, ANNULÉ, EXPIRED, ERROR).
Exemple : ACTIF
merchant_order_id chaîne
Identification du lien de paiement (MAX 255 ; MIN 3).
Exemple : 432245
created_at timestamp
La date et l'heure auxquelles le lien de paiement a été créé.
Exemple: 2022-05-09T20:46:54.786342Z
updated_at timestamp
Date et heure de la dernière mise à jour du lien de paiement.
Exemple: 2022-05-09T20:46:54.786342Z
capture booléen
Décide d'autoriser le paiement ou de le capturer. L'autorisation d'un paiement par carte vous permet de réserver
réserver des fonds sur le compte bancaire du client. Si le champ n'est pas envoyé, nous le considérons comme vrai. Vous pouvez par la suite capturer le
paiement via le tableau de bord de Yuno ou Méthode API.
Exemple : vrai
amount objet
Spécifie l’objet montant du paiement, avec la valeur et la devise.
currency enum
La devise utilisée pour effectuer le payment (MAX 3 ; MIN 3 ; ISO 4217).
Valeurs possibles : Voir la référence du pays.
value nombre
Le montant du payment (multiple de 0,0001).
Exemple : 12100.00
customer_payer objet
Spécifie l'objet client pour les liens de paiement.
id chaîne
L'identifiant unique du client sur la plateforme
plateforme Yuno (MAX 255 ; MIN 3).
Exemple: faa89e18-5a11-11ed-9b6a-0242ac120002
customer_id chaîne
L'identifiant unique du client chez le marchand externe (MAX 255 ; MIN 3).
Exemple : 23456
first_name chaîne
Le prénom du client (MAX 255 ; MIN 3).
Exemple : John
last_name chaîne
Le nom de famille du client (MAX 255 ; MIN 3).
Exemple : Doe
gender enum
Le sexe du client (MAX 2 ; MIN 1 ; (M=Mâle/F=Femme/NA=Non applicable/NK=Non connu)).
Valeurs possibles : M, F, NAou NK.
date_of_birth chaîne
La date de naissance du client au format AAAA-MM-JJ (Longueur : 10).
Exemple : 1990-02-28
email chaîne
L'e-mail du client (MAX 255 ; MIN 3).
Exemple : [email protected]
nationality enum
Nationalité du client (MAX 2 ; MIN 2 ; ISO 3166-1).
Valeurs possibles : Voir la référence du pays.
document objet
Spécifie l'objet document du client, y compris son numéro et son type.
document_number chaîne
Le numéro de document du client (MAX 40 ; MIN 3).
Exemple : 1093333333
document_type enum
Le type de document du client (MAX 6, MIN 2).
Valeurs possibles de l'énumération : Vérifier la
Référence du pays.
phone objet
Spécifie l'objet téléphonique du client, y compris le numéro et le code.
number chaîne
Le numéro de téléphone du client (MAX 40 ; MIN 3).
Exemple : 11992149494
country_code chaîne
Le code d'appel du pays du téléphone du client (MAX 3 ; MIN 1)
Valeurs possibles : Vérifier la
Référence du pays.
billing_address objet
Spécifie l'objet adresse de facturation du client.
address_line_1 chaîne
Ligne principale de l'adresse de facturation du client (MAX 255 ; MIN 3).
Exemple : Calle 34 # 56 - 78
address_line_2 chaîne
Ligne de l'adresse de facturation secondaire du client (MAX 255 ; MIN 3).
Exemple : Apartamento 502, Torre I
city chaîne
La ville considérée pour l'adresse de facturation (MAX 255 ; MIN 3).
Exemple : Bogota
country enum
Le pays considéré pour l'adresse de facturation (MAX 2 ; MIN 2 ; ISO
3166-1).
Valeurs possibles : Voir la référence du pays.
state chaîne
État considéré pour l'adresse de facturation (MAX 255 ; MIN 3).
Exemple : Cundinamarca
zip_code chaîne
Le code postal pris en compte pour l'adresse de facturation (MAX 11 ; MIN 4).
Exemple : 111111
shipping_address objet
Spécifie l'objet adresse de livraison du client.
address_line_1 chaîne
Ligne de l'adresse de livraison principale du client (MAX 255 ; MIN 3).
Exemple : Calle 34 # 56 - 78
address_line_2 chaîne
Ligne de l'adresse de livraison secondaire du client (MAX 255 ; MIN 3).
Exemple : Apartamento 502, Torre I
city chaîne
La ville considérée pour l'adresse de livraison (MAX 255 ; MIN 3).
Exemple : Bogota
country enum
Le pays considéré pour l'adresse de livraison (MAX 2 ; MIN 2 ; ISO
3166-1).
Valeurs possibles : Voir la référence du pays.
state chaîne
État considéré pour l'adresse de livraison (MAX 255 ; MIN 3).
Exemple : Cundinamarca
zip_code chaîne
Le code postal pris en compte pour l'adresse de livraison (MAX 11 ; MIN 4).
Exemple : 111111
additional_data objet
Spécifie l'objet additional_data. Cet objet n'est pas obligatoire. Cependant, si vous envoyez ces informations, l'expérience de paiement sera améliorée pour votre utilisateur.
airline objet
Spécifie l'objet compagnie aérienne. Les passagers et les billets doivent avoir les mêmes informations de commande.
pnr chaîne
Enregistrement du nom du passager (MAX 10 ; MIN 1).
Exemple : 1P-2UUGJW
legs tableau d'objets
Spécifie le tableau d'objets des pattes.
arrival_airport chaîne
Code aéroportuaire IATA (MAX 3 ; MIN 3). Voir http://www.iata.org.
Exemple : AMS
base_fare flotteur
Le montant de la transaction, hors taxes et frais, la plus petite unité monétaire (multiple de
0.0001).
Exemple : 23.5676
base_fare_currency chaîne
La devise utilisée pour le montant de la transaction (MAX 3 ; MIN 3 ; ISO 4217).
Exemple : Vérifier la référence du pays.
carrier_code chaîne
Code IATA du transporteur (MAX 2 ; MIN 2). Voir aussi http://www.iata.org.
Exemple : KL
departure_airport chaîne
Code IATA (MAX 3 ; MIN 3). Voir aussi http://www.iata.org.
Exemple : EZE
departure_airport_timezone chaîne
Fuseau horaire de l'aéroport (MAX 6 ; MIN 6).
Exemple : -03:00
departure_datetime timestamp
La date et l'heure de départ en heure locale à l'aéroport de départ.
Exemple: 2022-05-09T20:46:54.786342Z
fare_basis_code chaîne
Le code taux de base fournit des informations spécifiques sur le tarif en plus de la classe de service, toutes deux requises pour la réservation (MAX 15 ; MIN 1).
requises pour la réservation (MAX 15 ; MIN 1).
Exemple : HL7LNR
fare_class_code chaîne
Le code de la classe tarifaire de la compagnie aérienne (MAX 1 ; MIN 1). Les valeurs peuvent être des lettres (A-Z) mais peuvent varier en fonction de la définition de la compagnie aérienne.
selon la définition de la compagnie aérienne.
Exemple : C
flight_number chaîne
Le numéro de vol attribué par la compagnie aérienne (MAX 5 ; MIN 1).
Exemple : 842
stopover_code chaîne
Le code d'escale (code d'une lettre qui indique si le passager est autorisé à faire une escale).
escale.
Seuls deux types de caractères sont autorisés : O : Escale autorisée (la lettre "O", pas zéro) / X : Escale
pas
pas autorisée).
Exemple : O
passengers tableau d'objets
Spécifie le tableau d'objets représentant les passagers associés aux billets.
document objet
Spécifie l'objet du document pour le passager.
document_number chaîne
Le numéro du document du passager (MAX 40 ; MIN 3).
Exemple : 1093333333
document_type enum
Le type de document du passager (MAX 6, MIN 2).
Valeurs possibles de l'énumération : Vérifier la
Référence du pays.
country enum
Pays où le document a été délivré (MAX 2 ; MIN 2 ; ISO
3166-1).
Valeurs possibles : Voir la référence du pays.
date_of_birth chaîne
La date de naissance du passager au format AAAA-MM-JJ (MAX 10 ; MIN 10).
Exemple : 1990-02-28
email chaîne
email du passager (MAX 255 ; MIN 3).
Exemple : [email protected]
first_name chaîne
Le prénom du passager (MAX 255 ; MIN 3).
Exemple : John
last_name chaîne
Nom de famille du passager (MAX 255 ; MIN 3).
Exemple : Doe
loyalty_number chaîne
Numéro du programme de fidélisation des passagers (MAX 20, MIN 1).
Exemple : 254587547
loyalty_tier enum
Niveau du programme de fidélisation des passagers (MAX 255 ; MIN 3).
Valeurs possibles de l'énumération : Vérifier le
Niveau de loyauté.
middle_name chaîne
Deuxième prénom du passager (MAX 255 ; MIN 3).
Exemple : Charles
nationality enum
Nationalité du passager (MAX 2 ; MIN 2 ; ISO 3166-1).
Valeurs possibles : Voir la référence du pays.
type enum
Le type de passager (MAX 1 ; MIN 1).
Valeurs possibles de l'énumération : Vérifier la liste des types de passagers.
tickets tableau d'objets
Spécifie le tableau des billets associés aux passagers.
ticket_number chaîne
Numéro du billet (MAX 14 ; MIN 1).
Exemple : 7411823255523
e_ticket booléen
S'agit-il d'un billet électronique ?
Valeurs possibles : True ou False
restricted booléen
Indique si le ticket est réfutable ou non.
Valeurs possibles : True ou False
total_fare_amount flotteur
Montant total du tarif dans la plus petite unité monétaire (multiple de 0,0001).
Exemple : 80000
total_tax_amount flotteur
Montant total des taxes dans la plus petite unité monétaire (multiple de 0,0001).
Exemple : 14800
total_fee_amount flotteur
Montant total de la redevance dans la plus petite unité monétaire (multiple de 0,0001).
Exemple : 25200
issue objet
Spécifie l'objet de la question.
address chaîne
Adresse de l'agent qui a vendu le billet (MAX 255 ; MIN 3).
Exemple : Apartamento 502, Torre I
carrier_prefix_code chaîne
Transporteur émetteur ou valideur. Il s'agit du préfixe AWB (Air waybill), code IATA à trois chiffres (MAX
3 ; MIN
3).
Exemple : 044
city chaîne
Nom de la ville de l'agent qui a vendu le billet (MAX 255 ; MIN 3).
Exemple : Bogota
country enum
Code du pays où le billet a été émis (MAX 2 ; MIN 2 ; ISO
3166-1).
Valeurs possibles de l'énumération : Vérifier la liste des codes pays
liste.
date chaîne
Date d'émission du billet.
Exemple : 1979-01-12
travel_agent_code chaîne
Code de l'agence de voyage émettrice du billet.
Exemple : 10655823
travel_agent_name chaîne
Le nom sous lequel le point de vente apparaît sur la liste des agences ou le nom de la franchise (MAX 32 ;
MIN
1).
Exemple : Agence ACME Inc
order objet
Spécifie l'objet de l'ordre.
fee_amount flotteur
Le montant de la redevance de la commande (multiple de 0,0001).
Exemple : 1
shipping_amount flotteur
Le montant de la livraison de la commande (multiple de 0,0001).
Exemple : 1
items tableau d'objets
Spécifie l'objet de l'élément.
id chaîne
L'identifiant unique de l'élément (MAX 255 ; MIN 3).
Exemple : 3214
name chaîne
Le nom de l'élément (MAX 255 ; MIN 3).
Exemple : iPhone 12 Pro Max
quantity int
La quantité de l'article (MAX 999 ; MIN 1).
Exemple : 1
unit_amount flotteur
Le montant unitaire de l'article (multiple de 0,0001).
Exemple : 550
category chaîne
La catégorie de l'article (MAX 255 ; MIN 3).
Valeurs possibles : Vérifier la liste des catégories d'éléments.
brand chaîne
La marque de l'article (MAX 255 ; MIN 3).
Exemple : Apple
sku_code chaîne
L'unité de gestion des stocks (SKU) de l'article (MAX 255 ; MIN 3).
Exemple : A2342
manufacture_part_number chaîne
Le numéro de la pièce de fabrication de l'article (MAX 255 ; MIN 3).
Exemple : 345621234
picture_url chaîne
L'image de l'article (MAX 255 ; MIN 3).
Exemple : https://www.merchant_url.com/items/:id
seller_details objet
Spécifie l'objet des détails du vendeur.
name chaîne
Nom légal du vendeur (MAX 255 ; MIN 3).
Exemple : Jhon Doe
email chaîne
L'e-mail du vendeur (MAX 255 ; MIN 3).
Exemple : [email protected]
reference chaîne
Code d'identification du vendeur (MAX 255 ; MIN 3).
Exemple : Vendeur
website chaîne
URL du site web du vendeur (MAX 255 ; MIN 3).
Exemple : https://www.test.com/1231324
industry enum
Secteur d'activité du vendeur (MAX 255 ; MIN 3).
Valeurs possibles de l'énumération : Vérifier la catégorie de l'industrie.
country enum
Le pays du vendeur (MAX 255 ; MIN 3).
Valeurs possibles de l'énumération : Vérifier la liste des codes pays.
document objet
Spécifie l'objet du document du vendeur.
document_number chaîne
Le numéro de document du vendeur (MAX 40 ; MIN 3).
Exemple : 1093333333
document_type enum
Le type de document du vendeur (MAX 6, MIN 2).
Valeurs possibles de l'énumération : Vérifier la
Référence du pays.
phone objet
Spécifie l'objet numéro de téléphone du vendeur.
country_code chaîne
Le code d'appel du pays du téléphone du vendeur (MAX 3 ; MIN 1). Valeurs possibles : Vérifier le
Référence des pays.
Exemple : 57
number chaîne
Le numéro de téléphone du vendeur, sans l'indicatif du pays (MAX 32 ; MIN 1).
Exemple : 3132450765
address objet
Spécifie l'objet de l'adresse du vendeur.
address_line_1 chaîne
Ligne d'adresse principale du vendeur (MAX 255 ; MIN 3).
Exemple : Calle 34 # 56 - 78
address_line_2 chaîne
La ligne d'adresse de facturation secondaire du vendeur (MAX 255 ; MIN 3).
Exemple : Apartamento 502, Torre I
city chaîne
La ville considérée pour l'adresse du vendeur (MAX 255 ; MIN 3).
Exemple : Bogota
country enum
Le pays considéré pour l'adresse du vendeur (MAX 2 ; MIN 2,ISO
3166-1).
Valeurs possibles de l'énumération : Vérifier la liste des codes pays
liste.
state chaîne
État considéré pour l'adresse du vendeur (MAX 255 ; MIN 3).
Exemple : Cundinamarca
zip_code chaîne
Le code postal considéré pour l'adresse du vendeur (MAX 11 ; MIN 4).
Exemple : 111111
taxes tableau d'objets
Spécifie l'objet fiscal de la commande.
type chaîne
Type de taxe.
Exemple : TVA
tax_base flotteur
La base du montant pour appliquer la taxe définie.
Exemple : 10000
value flotteur
Le montant de la taxe.
Exemple : 2100
percentage flotteur
Le pourcentage de la taxe.
Exemple : 21
one_time_use booléen
Lien unique : Pour une collection unique avec des informations définies sur le produit, le montant et le client.
Lien multiple : Pour utiliser et partager autant de fois que nécessaire, avec une quantité et un produit définis.
Options : false permet une seule utilisation, true plusieurs paiements.
availability objet
Spécifie l'objet de disponibilité. Fait référence à la date d'expiration du lien de paiement.
start_at timestamp
Début de la période de validité du lien de paiement.
Exemple: 2022-05-09T20:46:54.786342Z
finish_at timestamp
Fin de la période de validité du lien de paiement.
Exemple: 2022-05-09T20:46:54.786342Z
callback_url chaîne
URL pour rediriger votre client après le paiement (MAX 255 ; MIN 3).
Exemple : https://www.your-site.com/
redirect_url chaîne
URL du lien de paiement (MAX 255 ; MIN 3).
Exemple : https://checkout.y.uno/payment_links/id
payment_method_types tableau d'enums
La liste des types de méthodes de paiement que les clients peuvent utiliser. Si aucune valeur n'est transmise, Yuno affichera les
méthodes de paiement définies dans le tableau de bord.
payment tableau d'objets
Tableau de Objets de paiement
metadata tableau d'objets
Spécifie une liste d’objets metadata. Vous pouvez ajouter jusqu’à 50 objets metadata.
metadata object objet
Spécifie une clé de métadonnées et la valeur correspondante.
key chaîne
Spécifie une clé de métadonnées.
Exemple : âge
value chaîne
Spécifie la valeur de la clé de métadonnées définie.
Exemple : 28
vault_on_success booléen
Indicateur d'enrôlement de la carte après un paiement réussi. Faux par défaut.
Exemple : faux