Creare il pagamento

Usa questa operazione dal backend del merchant per creare e pagare un ordine inline in un’unica richiesta. Puoi anche fornire il token di un ordine esistente. DEUNA applica le connessioni di pagamento e il comportamento di instradamento, rischio e acquisizione configurati per il merchant.

Inviare la selezione di rateChiedi ad Athia informazioni#

Quando il cliente seleziona un'opzione restituita da Elenca le opzioni di pagamento, conservare sia il numero di rate che l'ID dell'opzione:

{
  "payment_source": {
    "method_type": "credit_card",
    "card_info": {
      "card_id": "CARD_ID",
      "installments": 6,
      "installment": {
        "plan_option_id": "a4756a5f-7f9b-414d-8712-e3a9da2be337"
      }
    }
  }
}

Il numero di rate e l'ID dell'opzione devono corrispondere. L'ID dell'opzione identifica l'opzione di campagna/fornitore di DEUNA; il conteggio indica il numero di rate selezionato per l'elaborazione del pagamento. Fare riferimento a Installazioni per i requisiti di idoneità della campagna e per il flusso completo.

Inviare un pagamento con carta ricorrenteChiedi ad Athia informazioni#

I campi di ricorrenza appartengono all'interno dell'inline order. La transazione iniziale avviata dal titolare della carta stabilisce la credenziale ricorrente:

{
  "payer_info": {
    "email": "buyer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "payment_method": "TOKENIZED_PAYMENT_METHOD"
  },
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "subscription-1001-initial",
    "store_code": "main",
    "currency": "USD",
    "sub_total": 1000,
    "total_tax_amount": 0,
    "total_amount": 1000,
    "initiator_type": "customer",
    "recurrence": {
      "first_time_use": true,
      "scheduled": true,
      "bill_reference": "subscription-1001"
    }
  }
}

Dopo il primo addebito riuscito, conservare il order.recurrence.recurrence_idrestituito. Inviare quel valore con l'addebito successivo avviato dal merchant:

{
  "payer_info": {
    "email": "buyer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "payment_method": "STORED_PAYMENT_METHOD"
  },
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "subscription-1001-002",
    "store_code": "main",
    "currency": "USD",
    "sub_total": 1000,
    "total_tax_amount": 0,
    "total_amount": 1000,
    "initiator_type": "merchant",
    "recurrence": {
      "first_time_use": false,
      "scheduled": true,
      "recurrence_id": "RECURRING_CREDENTIAL_ID",
      "bill_reference": "subscription-1001"
    }
  }
}

Utilizzare il nome di campo esatto recurrence_id; è il contratto JSON pubblico utilizzato da Purchase V2. Un addebito successivo senza un identificatore valido non può essere associato alla credenziale di ricorrenza memorizzata per il processore selezionato.

Scegli come fornire l’ordineChiedi ad Athia informazioni#

Inizia con un ordine completo del settoreChiedi ad Athia informazioni#

Il order accetta lo stesso contesto aziendale modellato dall’API Orders. Ogni esempio di settore si apre con la richiesta inline Purchase V2 consigliata e consente anche di esaminare la richiesta facoltativa che crea prima l’ordine.

RispostaChiedi ad Athia informazioni#

Restituisce l’ordine elaborato, incluso il relativo order_tokentipo di ordine, stato risultante, informazioni di pagamento e informazioni sull'abbonamento, se applicabile. Considerare lo stato restituito come autorevole. Se rimane irrisolto, recuperare l'ordine originale dopo che DEUNA ha elaborato l'aggiornamento del provider asincrono.

Il pagamento è stato elaborato. Controlla gli stati dell’ordine e del pagamento per conoscere l’esito commerciale.

Il Gateway applica l’idempotenza a questa operazione. Invia unaChiedi ad Athia informazioni#

stabile per lo stesso tentativo commerciale e riutilizza la stessa chiave e lo stesso corpo dopo un errore di rete. Usa una nuova chiave per un tentativo diverso. X-Idempotency-Key Genera la chiave nel backend del merchant, mai nel browser o nell’app mobile.

• Non riutilizzare una chiave con un corpo diverso.
• Consulta l’ordine prima di avviare un nuovo tentativo quando l’esito non è certo.
• Riconcilia un esito incerto recuperando l’ordine prima di avviare un nuovo tentativo.

Vedi Richieste idempotenti Per il periodo di conservazione di 24 ore, il comportamento di ripetizione, i conflitti e le operazioni supportate. Continua con... , l’, Autenticazionee Codici di errore.