Créer un paiement

Utilisez cette opération depuis le backend marchand pour créer et payer une commande en ligne dans une seule requête. Vous pouvez aussi fournir le jeton d’une commande existante. DEUNA applique les connexions de paiement et le comportement de routage, de risque et de capture configurés pour le marchand.

Envoyer une sélection d'échéancesInterroger Athia à ce sujet#

Lorsque le client sélectionne une option renvoyée par Listez les options d'échéances, conservez les deux valeurs de cette même option :

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

Le nombre d'échéances et l'ID de l'option doivent correspondre. L'ID de l'option identifie l'option de campagne/fournisseur DEUNA ; le nombre indique le nombre d'échéances sélectionné pour le traitement du paiement. Voir Versements pour les conditions d'éligibilité et le flux complet.

Envoyer un paiement par carte récurrentInterroger Athia à ce sujet#

Les champs récurrents se placent à l'intérieur du orderinline. La transaction initiale initiée par le titulaire établit l'identifiant récurrent :

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

Après le premier débit réussi, conservez l' order.recurrence.recurrence_idrenvoyé. Envoyez cette valeur avec le débit ultérieur initié par le marchand :

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

Utilisez le nom de champ exact recurrence_id; c'est le contrat JSON public utilisé par Purchase V2. Un débit ultérieur sans identifiant valide ne peut pas être associé à l'identifiant récurrent stocké pour le processeur sélectionné.

Choisir comment fournir la commandeInterroger Athia à ce sujet#

Commencer avec une commande complète de l'industrieInterroger Athia à ce sujet#

Le order accepte le même contexte métier que celui modélisé par l’API Orders. Chaque exemple sectoriel commence par la requête en ligne Purchase V2 recommandée et permet aussi d’examiner la requête facultative qui crée d’abord la commande.

RéponseInterroger Athia à ce sujet#

Renvoie la commande traitée, notamment son order_token, type de commande, état résultant, informations de paiement et informations d'abonnement, si applicable. Traitez l'état retourné comme étant autoritaire. Si le problème persiste, récupérez la commande originale après que DEUNA ait traité la mise à jour asynchrone du fournisseur.

Le paiement a été traité. Consultez l’état de la commande et du paiement pour connaître le résultat métier.

La Gateway applique l’idempotence à cette opération. Envoyez uneInterroger Athia à ce sujet#

stable pour une même tentative métier et réutilisez la même clé et le même corps après une panne réseau. Utilisez une autre clé pour une tentative différente. X-Idempotency-Key Générez la clé dans le backend marchand, jamais dans le navigateur ou l’application mobile.

• Ne réutilisez jamais une clé avec un corps différent.
• Consultez la commande avant de lancer une nouvelle tentative lorsque le résultat est incertain.
• Rapprochez un résultat incertain en récupérant la commande avant de lancer une nouvelle tentative.

Voir Requêtes idempotentes Pour la période de conservation de 24 heures, le comportement de réexécution, les conflits et les opérations prises en charge. Continuez. , l’, Authentificationet Codes d’erreur.