Passa al contenuto principale
Tutti i sistemi operativiNovitàv1
Accedi

Vault di pagamento

Conservare e gettare le credenziali di pagamento per uso singolo o futuro

In questa pagina
Metodo di integrazione

Tokenizza le credenziali di pagamento per riutilizzarle in sicurezza.

Scegli un’esperienza Vault ospitata da DEUNA o un flusso API conforme PCI, ricevi un ID carta riutilizzabile ed elabora in sicurezza i pagamenti futuri.

Interfaccia
Inserimento delle credenziali ospitato da DEUNA o acquisizione del merchant conforme PCI
Modello di distribuzione
Componente SDK o API Cards autorizzata dal cliente
Ideale per
Carte salvate, checkout con un clic e pagamenti ricorrenti
Confronta i metodiApri riferimento

Comprendere i limiti del credential#

Il card_id restituito da un flusso di tokenizzazione supportato è un riferimento al credential di pagamento di DEUNA. La sua disponibilità per un pagamento successivo dipende dal consenso del cliente, dal tipo di token, dal conto del commerciante, dalla connessione al fornitore, dall'ambiente, dal paese e dall'operazione abilitata per quel flusso.

  • Non presumere che ogni credential memorizzato possa essere utilizzato tra diversi processori o metodi di pagamento.
  • Verificare il comportamento di rete-token, account-updater, portabilità, utilizzo ricorrente e cancellazione per l'account di destinazione prima dell'implementazione in produzione.
  • Mantenere i dati PAN, CVV, token del fornitore e credenziali private fuori dai log e dai metadati dell'applicazione.
  • Memorizzare il cliente, lo scopo del consenso, l'ora di tokenizzazione, lo stato del credential e l'uso futuro consentito nel vostro sistema di riferimento.
  • Supportare la revoca, la scadenza, la sostituzione e la cancellazione del credential del cliente senza trattare automaticamente un token cancellato come un abbonamento annullato.

Usa il Provider capabilities catalog Per il supporto di connessioni pubblicate, verificare il comportamento del credential specifico per l'account con il vostro Technical Account Manager di DEUNA.

Scegli un metodo di integrazione#

Payment Vault supporta sia gli SDK DEUNA sia l’API Cards autorizzata dal cliente. Entrambi i metodi restituiscono un card_id; scegli il metodo in base a chi gestisce l’esperienza di inserimento delle credenziali e al relativo ambito dello standard Payment Card Industry Data Security Standard (PCI DSS).

DEUNA SDKsVisualizza l’esperienza Vault DEUNA in un’applicazione web o mobile e ricevi i callback del ciclo di vita.API CardsTokenizza e archivia le carte tramite una richiesta API autenticata del cliente.

Integra l’API Cards#

Usa l’API Cards quando l’applicazione gestisce l’esperienza di inserimento della carta ed è preparata alle relative responsabilità PCI DSS. Questo è un flusso autorizzato dal cliente: autentica il cliente, quindi chiama POST /v2/users/{user_id}/cards con il token Bearer del cliente e il contesto merchant richiesto dal seguente endpoint per archiviare una carta.

:::info Rotta pubblica supportata Per le nuove integrazioni, usa solo POST /v2/users/{user_id}/cards. La rotta non versionata /users/{user_id}/cards preserva un contratto legacy a carta singola, mentre /users/{user_id}/cards/{card_id}/tokens aggiunge un token specifico del processore a una carta esistente e non è un endpoint di creazione carta. Nessuna delle due rotte fa parte del catalogo API esterno attuale. Vedi Differenze tra le rotte POST Card. :::

Il /v2 usa un corpo della richiesta in formato array JSON, anche quando archivi una sola carta:

curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/users/USER_ID/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "card_holder": "Jane Doe",
      "card_number": "CARD_NUMBER",
      "card_cvv": "CARD_CVV",
      "expiry_month": "12",
      "expiry_year": "2029",
      "is_default": true
    }
  ]'

Una richiesta riuscita restituisce HTTP 201 Created. Archivia il data[].id come card_id; non archiviare mai il PAN o il CVV inviati.

Carta creataJSON
{
  "data": [
    {
      "id": "8b5d0b45-e34f-4fd3-8cb5-79a7041f86ec",
      "company": "visa",
      "last_four": "4242",
      "expiration_date": "12/29"
    }
  ]
}

Dopo un timeout o una risposta ambigua, consulta Elencare le carte memorizzate prima di inviare nuovamente la carta. Il contratto del Gateway non pubblica un header di idempotenza per questa operazione, quindi i client non devono presumere che un nuovo tentativo sia idempotente. I metadati di verifica possono essere assenti finché DEUNA non verifica la credenziale; consulta Metadati di verifica della carta.

Integra un SDK DEUNA#

L'integrazione del Vault di Pagamento è attraverso SDK di DEUNA.

In ambienti web, il widget può essere aperto in un elemento HTML di destinazione o visualizzato come modale.

Scegli la tua piattaforma SDK:

Web SDKJavaScript e TypeScript per qualsiasi stack web.JavaScript · CDNReact NativeUn’unica integrazione per le app iOS e Android.TypeScript · iOS + AndroidiOSSDK Swift per applicazioni iOS native.Swift · SPMAndroidSDK Kotlin per applicazioni Android native.Kotlin · Gradle

Caratteristiche

  • L'SDK espone diversi Risponde alle chiamate che permettono al commerciante di reagire dinamicamente ad eventi importanti all'interno del flusso di pagamento, come ad esempio:
    • Quando l'utente chiude il widget.
    • Quando una carta o le credenziali di pagamento vengono tokenizzate con successo.
    • Quando un tentativo di tokenizzazione fallisce.
  • Il Vault di Pagamento può essere reso incorporato o come modal.

Ulteriori informazioni

Maggiori informazioni sull'integrazione del modulo di pagamento:

  • Verificare il tipo di evento e il marchio di carte: Il Vault riconosce i marchi di carte dai metadati di eventi.
  • Sconto applicato se la carta è Mastercard dal commerciante: Se la carta è Mastercard, viene applicato uno sconto del 20% sul carrello. Questa azione è eseguita interamente dalla tua app.
  • Aggiornamento dell'ordine: Dopo aver applicato uno sconto, la tua domanda è responsabile dell'aggiornamento dell'ordine utilizzando il punto finale DEUNA Update Order.
  • Notifica al widget per aggiornare l'ordine e le rate: Le modifiche dello stato di un ordine vengono comunicate utilizzando i callback SDK.
  • Visualizza un tag promozionaleInoltre all'aggiornamento dell'importo dell'ordine e del pagamento, è possibile applicare stili CSS personalizzati al widget attivo utilizzando setCustomStyles(...). Vedi il Guida SDK Web.

Elaborare un pagamento con il credential restituito card_id

Per elaborare un pagamento in DEUNA con dato card_id utilizzare API acquisto.

Esempio richiesta curl

JavaScript
const requestBody = {
    payer_info: {
        email: "eposada@deuna.com"
    },
    payment_source: {
        method_type: "credit_card",
        card_info: {
            card_id: "8d369b6e-113a-4640-9e63-dc29957fc86a",
            installment: {
            	plan_option_id: "<uuid que se retorna en el postMessage 'onInstallmentSelected'>"
            }
        }
    },
    // ... Remaining of the request body
};

fetch('https://api.sandbox.deuna.io/v2/merchants/orders/purchase', {
    method: 'POST',
    headers: {
        'x-api-key': '<YOUR_PRIVATE_API_KEY>',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(requestBody)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl --location 'https://api.sandbox.deuna.io/v2/merchants/orders/purchase' \
--header 'x-api-key: YOUR_PRIVATE_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payer_info": {
        "email": "foo@bar.com"
    },
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "card_id": "8d369b6e-113a-4640-9e63-dc29957fc86a"
        }
    },
    "order": {
        "order_id": "testapi-0003",
        "currency": "MXN",
        "items": [
          {
              "id": "216",
              "name": "10 Cellphones",
              "description": "",
              "options": "string option",
              "total_amount": {
                  "original_amount": 2000,
                  "amount": 2000,
                  "currency": "MXN",
                  "currency_symbol": "$"
              },
              "unit_price": {
                  "amount": 200,
                  "currency": "MXN",
                  "currency_symbol": "$"
              },
              "tax_amount": {
                  "amount": 0,
                  "currency": "MXN",
                  "currency_symbol": "$"
              },
              "quantity": 1,
              "uom": "string",
              "upc": "string",
              "sku": "",
              "isbn": "",
              "brand": "",
              "manufacturer": "",
              "category": "",
              "color": "",
              "size": "",
              "weight": {
                  "amount": 0,
                  "unit": "kg"
              },
              "image_url": "https://images-staging.getduna.com/95463fb5-6279-4ec3-8ff9-fe07aacd2142/db5b698c57654116_domicilio_216_750x750_1662162887.png?d=200x200&format=webp",
              "details_url": "",
              "type": "physcal",
              "taxable": true
          }
        ],
        "sub_total": 2000,
        "total_amount": 2000,
        "store_code": "all",
        "billing_address": {
            "address1": "presa angostura 36PH",
            "address2": "",
            "address_type": "home",
            "city": "CDMX",
            "country_code": "MX",
            "email": "foo@bar.com",
            "first_name": "efren",
            "identity_document": "162915134",
            "is_default": true,
            "last_name": "garcia",
            "phone": "+525222222222",
            "state_code": "MX",
            "state_name": "miguel hidalgo",
            "zipcode": "11500"
        }
    }
}'
PHP
$curl = curl_init();

$requestBody = json_encode(array(
    "payer_info" => array(
        "email" => "foo@bar.com"
    ),
    "payment_source" => array(
        "method_type" => "credit_card",
        "card_info" => array(
            "card_id" => "8d369b6e-113a-4640-9e63-dc29957fc86a"
        )
    ),
    // Aquí puedes continuar añadiendo el resto del cuerpo de la solicitud
    "order" => array(
        "order_id" => "testapi-0003",
        "currency" => "MXN",
        "items" => array(
            // Aquí van los detalles de los items
        ),
        // Continúa con el resto de los detalles del pedido
    )
));

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.sandbox.deuna.io/v2/merchants/orders/purchase",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => $requestBody, // Aquí se utiliza la variable
  CURLOPT_HTTPHEADER => array(
    "x-api-key: YOUR_PRIVATE_API_KEY", // Asegúrate de reemplazar con tu API key real
    "Content-Type: application/json"
  ),
));


$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
Ruby
require 'uri'
require 'net/http'
require 'json'

url = URI("https://api.sandbox.deuna.io/v2/merchants/orders/purchase")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request_body = {
    payer_info: {
        email: "foo@bar.com"
    },
    payment_source: {
        method_type: "credit_card",
        card_info: {
            card_id: "8d369b6e-113a-4640-9e63-dc29957fc86a"
        }
    }
    # ... Agrega aquí el resto del cuerpo de la solicitud
}.to_json

request = Net::HTTP::Post.new(url)
request["x-api-key"] = "YOUR_PRIVATE_API_KEY" # Reemplaza con tu API key
request["Content-Type"] = "application/json"
request.body = request_body

response = http.request(request)
puts response.read_body
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONObject;

public class Main {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        
        JSONObject requestBody = new JSONObject()
            .put("payer_info", new JSONObject().put("email", "foo@bar.com"))
            .put("payment_source", new JSONObject()
                .put("method_type", "credit_card")
                .put("card_info", new JSONObject().put("card_id", "8d369b6e-113a-4640-9e63-dc29957fc86a")))
            // ... Agrega aquí el resto del cuerpo de la solicitud

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.sandbox.deuna.io/v2/merchants/orders/purchase"))
            .header("x-api-key", "YOUR_PRIVATE_API_KEY") // Reemplaza con tu API key
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(requestBody.toString()))
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}

Demo

Dopo aver integrato il Vault di Pagamento, l'esperienza è simile alla seguente demo: