Bizum via l'API directe

Intégrez Bizum comme moyen de paiement dans votre application via l'API directe DEUNA.

Aperçu#

Bizum est un moyen de paiement instantané espagnol qui permet aux utilisateurs de payer en utilisant leur numéro de téléphone mobile. DEUNA intègre Bizum via Redsys TPV Virtual en utilisant un modèle de redirection : après avoir lancé l'achat via l'API DEUNA, l'utilisateur est redirigé vers une page hébergée par Redsys pour terminer l'authentification Bizum, puis renvoyé sur votre site.

Exigences :

• Disponible uniquement en Espagne
• Devise : EUR uniquement
• L'utilisateur doit avoir un compte Bizum actif lié à une banque espagnole

Acheter la v2#

Les achats V2 effectuent la création de commande et l’initiation du paiement dans un seul point de terminaison.

Le processus d'achat Bizum se déroule comme suit :

1. Appels d'utilisateurs POST v2/merchants/order/purchase avec les informations de commande.
2. DEUNA crée la commande et initie la transaction Bizum avec Redsys.
3. DEUNA renvoie une URL de redirection dans la réponse.
4. Vous redirigez l'utilisateur vers cette URL pour terminer l'authentification Bizum sur la page Redsys.
5. Après authentification, Redsys redirige l'utilisateur vers votre site.
6. DEUNA écoute la notification de serveur à serveur Redsys pour confirmer le statut de paiement final.

Intégrer Bizum par API#

1. Effectuer un achat Bizum

Faites une demande au Achat V2 endpoint.

Pour effectuer un achat Bizum avec DEUNA, la charge utile V2 doit contenir :

• Les données de la commande
• URL de rappel pour rediriger l'utilisateur après paiement
• En option, le numéro de téléphone portable de l'utilisateur pour pré-remplir l'écran Bizum

Exemple de demande

{
  "order_type": "DEUNA_CHECKOUT",
  "payment_source": {
    "method_type": "bank_transfer",
    "processor": "redsys_bizum",
    "method_type_specific_fields": {
      "bizum_mobile_number": "+34700000000"
    }
  },
  "callback_urls": {
    "on_success": "https://example.com/success",
    "on_error": "https://example.com/error"
  },
  "order": {
    "order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
    "store_code": "all",
    "currency": "EUR",
    "total_amount": 1050,
    "items_total_amount": 1050,
    "sub_total": 1050,
    "items": [
      {
        "id": "1",
        "name": "Cinema ticket",
        "description": "Standard ticket",
        "total_amount": {
          "amount": 1050,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "unit_price": {
          "amount": 1050,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "quantity": 1
      }
    ]
  }
}

2. Rediriger l'utilisateur

Une fois l'achat lancé, l'API répond avec une URL de redirection dans le next_action node.

1. Prenez l'URL
2. Redirigez l'utilisateur vers cette URL.
3. L'utilisateur complète l'authentification Bizum sur la page Redsys :
   • Saisit son numéro de téléphone portable
   • Saisit son code PIN Bizum
   • Confirme via OTP (SMS ou dans l'application)
4. Après l'authentification, Redsys redirige l'utilisateur vers votre callback_urls.on_success ou callback_urls.on_error.
5. Écoutez les webhooks DEUNA pour confirmer le statut du paiement final.

Exemple de réponse

{
  "order_type": "DEUNA_CHECKOUT",
  "order_token": "db3fc147-2a4e-460f-a874-f6f79b1e651c",
  "order": {
    "order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
    "currency": "EUR",
    "total_amount": 1050,
    "status": "pending",
    "payment": {
      "data": {
        "status": "pending",
        "method_type": "bank_transfer",
        "processor": "redsys_bizum",
        "next_action": {
          "action": "authorization_bank_transfer",
          "authorization_bank_transfer": {
            "redirect_url": "https://sis-t.redsys.es:25443/sis/realizarPago"
          }
        }
      }
    }
  }
}

Tests#

À des fins de test, vous pouvez utiliser les données suivantes.

• Si un code PIN ou SMS est demandé, vous devez saisir 1234 comme code PIN et 123456 comme code SMS :

Utilisateur Bizum :

• Réussi : 700 000 000
• Refusé : ko@ko.ko

Attention, selon le montant envoyé et le type d'opération testée, le résultat peut varier.

• En dessous de 5€ : réussi
• Entre 5€ et 10€ : refusé
• Attention, le montant de la transaction ne doit pas dépasser 10 € ; sinon, l'opération sera rejetée.