Sign in

v9

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-05-05502770.7 KB
NativeCheckout

$viva->nativeCheckout->createTransaction()

Exécute une transaction à partir d'un token de charge obtenu via createChargeToken().

$txn = $viva->nativeCheckout->createTransaction(
    chargeToken: $token['chargeToken'],
    amount: 1500,
    currencyCode: 978,             // EUR (ISO 4217 numérique)
    sourceCode: '1234',
    merchantTrns: 'ref_123',       // Référence interne
    customerTrns: 'Consultation',  // Affiché au client
    preauth: false,
    tipAmount: 0,
    installments: null,
);

echo $txn['transactionId']; // UUID
echo $txn['statusId'];      // 'F' = finalisée
echo $txn['amount'];        // 1500
echo $txn['orderCode'];     // Code de l'ordre
post/NativeCheckout/createTransaction

Request body

chargeTokenstring required

Token obtenu via createChargeToken()

amountinteger required

Montant en centimes

currencyCodeinteger

Code devise ISO 4217 numérique (978 = EUR)

sourceCodestring nullable

Code source de paiement

merchantTrnsstring nullable

Référence interne

customerTrnsstring nullable

Description affichée au client

preauthboolean

Pré-autorisation uniquement ?

tipAmountinteger

Pourboire en centimes

installmentsinteger nullable

Nombre de versements (null = désactivé)

Example request

{
  "amount": 1500
}

Response

Transaction créée

transactionIdstring uuid

UUID de la transaction

statusIdstring

Statut ('F' = finalisée)

amountinteger

Montant en centimes

orderCodeinteger

Code de l'ordre