Mises à jour pour novembre 2024

Découvrez les dernières mises à jour de Yuno, notamment les détails relatifs à l'expiration des cartes, les paiements fractionnés améliorés, les reçus de remboursement, les articles d'abonnement et les paiements avec tokens conservés dans un coffre-fort. Consultez les mises à jour ci-dessous.

Il y a eu des mises à jour sur Yuno. Veuillez consulter les mises à jour ci-dessous.

Détails relatifs à l'expiration de la carte
Destinataires pour le marché des paiements fractionnés
Reçus pour les transactions annulées
Articles pour les abonnements
Paiements avec tokens stockés dans un coffre-fort

Détails relatifs à l'expiration de la carte

Nous avons ajouté deux champs supplémentaires à la réponse de paiement, appelés expiration_year et expiration_monthLes champs (à l'intérieur de chaque transaction.card_data) précisent les détails d'expiration de la carte utilisée pour effectuer le paiement, vous fournissant ainsi les informations sans avoir à accéder au mode de paiement.

[...]
"card_data": {
                    "holder_name": "Paco",
                    "iin": "48710499",
                    "lfd": "9910",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "BNP PARIBAS FORTIS",
                    "issuer_code": null,
                    "country_code": "BE",
                    "category": "CLASSIC",
                    "type": "DEBIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "71000db4-f8e7-4ea0-a2cc-9d9ebb76a955",
                    "expiration_month": 3,
                    "expiration_year": 30
[...]

Destinataires pour Split Marketplace

Nous avons ajouté une nouvelle fonctionnalité aux demandes du marché des paiements fractionnés, appelée « Destinataires ». Si vous utilisez plusieurs prestataires de paiement pour les paiements fractionnés, nous vous recommandons d'utiliser l'objet « Destinataires », car il vous permet de définir plusieurs prestataires pour chaque destinataire.

Création d'un destinataire

{
    "account_id": "{{account-code}}",
    "providers": [{
        "id": "PAGARME",
        "recipient_id": "XXXXXXXX"
    }],
    "external_id": "AAAA05",
    "national_entity": "INDIVIDUAL",
    "first_name": "John",
    "last_name": "Doe",
    "legal_name": "Arcos dorados S.A.",
    "email": "[email protected]",
    "country": "CO",
    "document": {
        "document_number": "1093333333",
        "document_type": "CC"
    },
    "phone": {
        "country_code": "57",
        "number": "3132450765"
    },
    "address": {
        "address_line_1": "Calle 34 # 56 - 78",
        "address_line_2": "Apartamento 502, Torre I",
        "city": "Bogota",
        "country": "CO",
        "state": "Cundinamarca",
        "zip_code": "111111"
    }
}

Envoi d'un paiement

[...],
"amount": {
        "currency": "BRL",
        "value": 1000
    },
"split_marketplace": [
                {
                    "amount": {
                        "currency": "BRL",
                        "value": 500
                    },
                    "recipient_id": "09d8bad7-4efe-47e2-b9ee-f4028460bab1",
                    "type": "PURCHASE"
                },
                {
                    "amount": {
                        "currency": "BRL",
                        "value": 500
                    },
                    "recipient_id": "d94e02c1-cc47-4e60-a20a-2b17fe58992d",
                    "type": "PURCHASE"
                }
            ],
[...]

Pour plus d'informations, veuillez vous reporter à la demande relative au marché des paiements fractionnés dans la section Guides API.

Reçus pour les transactions de remboursement

Nous avons ajouté une nouvelle fonctionnalité aux demandes de remboursement appelée « Reçus ». Cette fonctionnalité vous permet d'obtenir un reçu pour chaque transaction de remboursement effectuée dans Yuno. Comme Yuno n'effectue pas réellement le remboursement aux acquéreurs, ce reçu représente l'exécution de la demande auprès du fournisseur afin de rembourser l'achat effectué précédemment.

{
  "description": "Duplicate",
  "reason": "REQUESTED_BY_CUSTOMER",
  "merchant_reference": "AAB01-432245",
  "response_additional_data": 
    	{
          "receipt": true,
          "receipt_language": "ES"
        }
}

Une fois le REMBOURSEMENT créé, vous pouvez effectuer un obtenir le paiement pour trouver le reçu créé dans le champ « receipt_url » dans le payment.transaction .

Pour plus d'informations, veuillez vous reporter à la demande de remboursement dans la section Référence API.

Articles pour les abonnements

Nous avons ajouté une nouvelle fonctionnalité à l'option Abonnement, appelée Données supplémentaires. Yuno vous permet désormais de préciser des informations sur les articles liés à l'abonnement afin que nous puissions transmettre ces informations aux fournisseurs.

{
  "name": "Test Subscription",
  "description": "Subscription Test",
  "merchant_reference": "subscription-ref-merchant-AA01",
  "account_id": "{{account-code}}",
  "country": "BR",
  "additional_data": {
    "order": {
      "items": [
        {
          "category": "art",
          "id": "AA01",
          "name": "Test item",
          "quantity": 1,
          "unit_amount": 10
        }
      ]
    }
  },
  "amount": {
    "currency": "BRL",
    "value": 1500
  },
  "frequency": {
    "type": "MONTH",
    "value": 1
  },
  "billing_cycles": {
    "total": 12
  },
  "customer_payer": {
    "id": "a1d3b664-e32a-4508-9da1-9ede3e62a60c"
  },
  "payment_method": {
    "type": "CARD",
    "vaulted_token": "d4aa3586-def2-4705-b7cd-fe064bb764e6"
  },
}
'

Pour plus d'informations, veuillez vous reporter à la section Référence API des abonnements.

Paiements avec tokens stockés dans un coffre-fort

Nous avons ajouté une nouvelle fonctionnalité au produit Payouts, qui vous permet de créer des demandes directement vers une carte de crédit/débit enregistrée dans Yuno, si cela est pris en charge par le fournisseur.

[...],
"withdrawal_method": {
    "type": "CARD",
    "provider_id": "UNLIMINT",
    "vaulted_token":"[the payment method vaulted token]"
  }
[...]

Pour plus d'informations, veuillez consulter :

Section du guide d'inscription consacrée au processus d'inscription.
Section de référence de l'API Payouts pour la création de paiements.