Aller au contenu principal

Achat de biens et services sans enregistrement utilisateur

Dans cet exemple, nous démontrons comment passer une commande en tant qu'invité sans nécessiter d'enregistrement utilisateur.

✅ Objectif du scénario :

  • L'utilisateur n'est pas autorisé.
  • L'utilisateur remplit un formulaire avec des contacts (par exemple, guest_orders).
  • Sélectionne des produits (vous pouvez pré-configurer une liste).
  • La commande est passée pour l'utilisateur guest_user.

✅ Ce dont vous avez besoin :

  • Un PROJECT_URL et un APP_TOKEN valides pour l'authentification avec l'API OneEntry.
  • Un marqueur du formulaire de commande d'invité, par exemple guest_orders
  • Une liste productId et quantité

📌 Important :

  • Les champs du formulaire (marqueur, type) doivent correspondre aux paramètres du formulaire dans le panneau d'administration.
  • Si vous devez envoyer une notification concernant une commande, vous pouvez utiliser Events.
  • Ces exemples n'incluent pas la gestion des erreurs.
  • Vous pouvez gérer les erreurs en utilisant un bloc try-catch ou en employant une construction comme await Promise.catch((error) => error).

📚 Voir dans la documentation :

📦 Référence SDK :

Essayez-le en direct​

Exécutez cette méthode de manière interactive dans le bac à sable JS SDK — connectez votre Project URL et App Token lors de votre première visite, puis ouvrez :

Scénario​

1. Importer defineOneEntry depuis SDK définir PROJECT_URL et APP_TOKEN​

Exemple :

import { defineOneEntry } from 'oneentry';
import { IOrderData } from 'oneentry/dist/orders/ordersInterfaces';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. Création d'un client API​

Exemple :

const { AuthProvider, Orders, Payments } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. Nous formons un tableau avec les champs requis pour l'autorisation de l'utilisateur​

Exemple :

const authData = [
  {
    // registration form email marker
    marker: 'email_reg',
    value: 'your-email',
  },
  {
    // registration form password marker
    marker: 'password_reg',
    value: 'your-password',
  },
];
Résultat :
[
  {
    "marker": "email_reg",
    "value": "kvasssukr.net@gmail.com"
  },
  {
    "marker": "password_reg",
    "value": "123456"
  }
]

4. Se connecter en tant qu'utilisateur invité pour passer une commande​

Exemple :

const user = await AuthProvider.auth('email', {
  authData: authData,
});
console.log(user);
Résultat :
{
  "userIdentifier": "kvasssukr.net@gmail.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

5. Générer des données qui sont généralement reçues du formulaire frontend​

Exemple :

const guestFormData = [
  {
    marker: 'guest_name',
    type: 'string',
    value: 'Christina Thomas',
  },
  {
    marker: 'guest_phone',
    type: 'string',
    value: '+18005000500',
  },
  {
    marker: 'guest_email',
    type: 'string',
    value: 'guest@yourmail.com',
  },
];
const productsData = [
  {
    productId: 15,
    quantity: 1,
  },
];
const body: IOrderData = {
  formIdentifier: 'guest_order',
  paymentAccountIdentifier: 'cash',
  formData: guestFormData,
  products: productsData,
};
Résultat :
[
  {
    "productId": 15,
    "quantity": 1
  }
]

6. Créer une commande d'invité​

Exemple :

const order = await Orders.createOrder('guest_orders', body);

if ('statusCode' in order) {
  throw new Error(order.message);
}
Résultat :
{
  "id": 113,
  "formIdentifier": "guest_order",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "marker": "guest_name",
      "type": "string",
      "value": "Christina Thomas"
    },
    {
      "marker": "guest_phone",
      "type": "string",
      "value": "+18005000500"
    },
    {
      "marker": "guest_email",
      "type": "string",
      "value": "guest@yourmail.com"
    }
  ],
  "products": [
    {
      "productId": 15,
      "quantity": 1
    }
  ],
  "currency": "USD",
  "totalSum": 400,
  "bonusApplied": 0,
  "totalDue": 400,
  "discountConfig": {
    "orderDiscounts": [],
    "productDiscounts": [],
    "coupon": null,
    "settings": {
      "allowStacking": false,
      "maxDiscountValue": null,
      "allowGiftStacking": false,
      "maxBonusPaymentPercent": null,
      "minBonusAmount": null,
      "minOrderAmountForBonus": null,
      "giftRefundPolicy": "KEEP_GIFT"
    },
    "additionalDiscountsMarkers": [],
    "totalRaw": 400,
    "totalSumWithDiscount": 400,
    "excludedGiftProductIds": [],
    "bonus": {
      "availableBalance": 0,
      "maxBonusDiscount": 0,
      "minBonusAmount": null,
      "minOrderAmountForBonus": null,
      "bonusApplied": 0
    },
    "bonusApplied": 0,
    "totalDue": 400
  },
  "statusIdentifier": "guest_upcoming",
  "statusLocalizeInfos": {
    "title": "Upcoming"
  },
  "createdDate": "2026-06-06T11:37:20.044Z"
}

7. Création de la session de paiement​

Exemple :

const paymentSession = await Payments.createSession(
  order.id,
  'session',
  false,
);
console.log(paymentSession);
Résultat :
{
  "id": 62,
  "createdDate": "2026-06-06T11:37:21.260Z",
  "updatedDate": "2026-06-06T11:37:21.260Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 113,
  "amount": null,
  "paymentUrl": null
}

8. Obtenir un objet de session de paiement par identifiant de commande avec Payments.getSessionByOrderId()​

Exemple :

const sessionByOrderId = await Payments.getSessionByOrderId(order?.id).catch(
  (e: any) => e,
);

console.log(sessionByOrderId, paymentSession, user);
Résultat :
[
  {
    "id": 62,
    "createdDate": "2026-06-06T11:37:21.260Z",
    "updatedDate": "2026-06-06T11:37:21.260Z",
    "type": "session",
    "status": "waiting",
    "paymentAccountId": 1,
    "orderId": 113,
    "amount": null,
    "paymentUrl": null
  }
]

Exemple final​

// 1. Import defineOneEntry from SDK define PROJECT_URL and APP_TOKEN
import { defineOneEntry } from 'oneentry';
import { IOrderData } from 'oneentry/dist/orders/ordersInterfaces';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

// 2. Creating an API client
const { AuthProvider, Orders, Payments } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. We form an array with fields required for user authorization
const authData = [
  {
    // registration form email marker
    marker: 'email_reg',
    value: 'your-email',
  },
  {
    // registration form password marker
    marker: 'password_reg',
    value: 'your-password',
  },
];

// 4. Log in as a guest user to place an order
const user = await AuthProvider.auth('email', {
  authData: authData,
});
console.log(user);

// 5. Generate data that is usually received from the frontend form
const guestFormData = [
  {
    marker: 'guest_name',
    type: 'string',
    value: 'Christina Thomas',
  },
  {
    marker: 'guest_phone',
    type: 'string',
    value: '+18005000500',
  },
  {
    marker: 'guest_email',
    type: 'string',
    value: 'guest@yourmail.com',
  },
];
const productsData = [
  {
    productId: 15,
    quantity: 1,
  },
];
const body: IOrderData = {
  formIdentifier: 'guest_order',
  paymentAccountIdentifier: 'cash',
  formData: guestFormData,
  products: productsData,
};

// 6. Create a guest order
const order = await Orders.createOrder('guest_orders', body);

if ('statusCode' in order) {
  throw new Error(order.message);
}

// 7. Creation of payment session
const paymentSession = await Payments.createSession(
  order.id,
  'session',
  false,
);
console.log(paymentSession);

// 8. Get one payment session object by order identifier with [Payments.getSessionByOrderId()](/docs/payments/getSessionByOrderId)
const sessionByOrderId = await Payments.getSessionByOrderId(order?.id).catch(
  (e: any) => e,
);

console.log(sessionByOrderId, paymentSession, user);