Bizum tramite API diretta

Integra Bizum come metodo di pagamento nella tua applicazione tramite l'API diretta DEUNA.

Panoramica#

Bizum è un metodo di pagamento istantaneo spagnolo che consente agli utenti di pagare utilizzando il loro numero di telefono cellulare. DEUNA integra Bizum attraverso Redsys TPV Virtual utilizzando un modello redirect: dopo aver avviato l'acquisto tramite l'API DEUNA, l'utente viene reindirizzato a una pagina ospitata da Redsys per completare l'autenticazione Bizum, quindi ritornato al tuo sito.

Requisiti:

• Disponibile solo in Spagna
• Valuta: solo EUR
• L'utente deve avere un account attivo Bizum collegato a una banca spagnola

Acquisto v2#

Gli acquisti V2 effettuano la creazione dell'ordine e l'iniziazione del pagamento in un unico punto di vista.

Il processo di acquisto Bizum va come segue:

1. Chiamate utente POST v2/merchants/order/purchase con le informazioni sull'ordine.
2. DEUNA crea l'ordine e avvia la transazione Bizum con Redsys.
3. DEUNA restituisce un URL reindirizzato nella risposta.
4. Reindirizza l'utente a quell'URL per completare l'autenticazione Bizum nella pagina Redsys.
5. Dopo l'autenticazione, Redsys reindirizza l'utente al tuo sito.
6. DEUNA ascolta la notifica server-to-server Redsys per confermare lo stato di pagamento finale.

Integrare Bizum per API#

1. Fare un acquisto Bizum

Fai una richiesta al V2 acquisto endpoint.

Per effettuare un acquisto Bizum con DEUNA, il carico di pagamento V2 deve contenere:

• I dati dell'ordine
• URL di Callback per reindirizzare l'utente dopo il pagamento
• Opzionalmente, il numero di telefono cellulare dell'utente per pre-riempire la schermata di Bizum

Esempio di richiesta

{
  "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. Reindirizza l'utente

Dopo l'avvio dell'acquisto, l'API risponde con un URL reindirizzato nel next_action node.

1. Prendi l'URL
2. Reindirizza l'utente a quell'URL.
3. L'utente completa l'autenticazione Bizum nella pagina Redsys:
   • Inserisci il numero di telefono cellulare
   • Entra nel loro PIN di Bizum
   • Conferma tramite OTP (SMS o in-app)
4. Dopo l'autenticazione, Redsys reindirizza l'utente al tuo callback_urls.on_success o callback_urls.on_error.
5. Ascoltate i webhooks DEUNA per confermare lo stato di pagamento finale.

Esempio di risposta

{
  "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"
          }
        }
      }
    }
  }
}

Testing#

Per scopi di test, è possibile utilizzare i seguenti dati.

• Se è richiesto un codice PIN o SMS, è necessario inserire 1234 come il PIN e 123456 come il codice SMS:

utente di Bizum:

• Successo: 700 000 000
• Denied: ko@ko.ko

Si prega di notare che, a seconda dell'importo inviato e del tipo di operazione testata, il risultato può variare.

• Sotto 5€: successo
• Tra 5€ e 10€: negato
• Si prega di notare che l'importo della transazione non deve superare i 10 euro; altrimenti l'operazione verrà rifiutata.