Saltar al contenido principal

Pago por el pedido de un usuario registrado

En este ejemplo, demostramos cómo procesar un pago por un pedido realizado por un usuario registrado utilizando la API de OneEntry.

✅ Propósito del escenario:

  • Autorización de usuario registrado
  • Crear pedido
  • Creación de sesión de pago

✅ Lo que necesitas:

  • Un PROJECT_URL y APP_TOKEN válidos para la autenticación con la API de OneEntry.
  • Usuario registrado
  • Almacenamiento de pedidos configurado con el marcador "orders"

📌 Importante:

  • Estos ejemplos no incluyen el manejo de errores.
  • Puedes gestionar errores utilizando un bloque try-catch o empleando una construcción como await Promise.catch((error) => error).

📚 Ver en la documentación:

📦 Referencia del SDK:

Pruébalo en vivo​

Ejecuta este método de forma interactiva en el sandbox del JS SDK — conecta tu Project URL y App Token en la primera visita, luego abre:

Escenario​

1. Importar defineOneEntry del SDK y definir PROJECT_URL y APP_TOKEN​

Ejemplo:

import { defineOneEntry } from 'oneentry';

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

2. Creando un cliente API​

Ejemplo:

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

3. Autorización de usuario con AuthProvider.auth('email', authData)​

Ejemplo:

const authData = {
  authData: [
    {
      marker: 'email_reg',
      value: 'your-email',
    },
    {
      marker: 'password_reg',
      value: 'your-password',
    },
  ],
};
const user = await AuthProvider.auth('email', authData);
console.log(user);
Resultado:
{
  "userIdentifier": "kvasssukr.net@gmail.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

4. Crear pedido con Orders.createOrder()​

Datos:

{
  "formIdentifier": "order",
  "paymentAccountIdentifier": "cash",
  "formData": {
    "en_US": [
      {
        "type": "string",
        "marker": "name",
        "value": "Christina Thomas"
      }
    ]
  },
  "products": [
    {
      "productId": 15,
      "quantity": 1
    }
  ]
}

Ejemplo:

const body = {
  formIdentifier: 'order',
  paymentAccountIdentifier: 'cash',
  formData: [
    {
      type: 'string',
      marker: 'name',
      value: 'Christina Thomas',
    },
  ],
  products: [
    {
      productId: 15,
      quantity: 1,
    },
  ],
};
const orderData = (await Orders.createOrder('orders', body as any).catch(
  (e: any) => e,
)) as any;

if ('statusCode' in orderData) {
  throw new Error(orderData.message);
}
Resultado:
{
  "id": 116,
  "formIdentifier": "order",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "type": "string",
      "marker": "name",
      "value": "Christina Thomas"
    }
  ],
  "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": "upcoming",
  "statusLocalizeInfos": {
    "title": "Upcoming"
  },
  "createdDate": "2026-06-06T11:38:21.644Z"
}

5. Creación de sesión de pago con Payments.createSession()​

Ejemplo:

const sessionData = await Payments.createSession(
  orderData?.id,
  'session',
).catch((e: any) => e);
Resultado:
{
  "id": 65,
  "createdDate": "2026-06-06T11:38:22.125Z",
  "updatedDate": "2026-06-06T11:38:22.125Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 116,
  "amount": null,
  "paymentUrl": null
}

6. Obtener un objeto de sesión de pago por el identificador del pedido con Payments.getSessionByOrderId()​

Ejemplo:

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

console.log({ user, sessionData, sessionByOrderId });
Resultado:
[
  {
    "id": 65,
    "createdDate": "2026-06-06T11:38:22.125Z",
    "updatedDate": "2026-06-06T11:38:22.125Z",
    "type": "session",
    "status": "waiting",
    "paymentAccountId": 1,
    "orderId": 116,
    "amount": null,
    "paymentUrl": null
  }
]

Ejemplo final​

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

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. User authorization with AuthProvider.auth('email', authData)
const authData = {
  authData: [
    {
      marker: 'email_reg',
      value: 'your-email',
    },
    {
      marker: 'password_reg',
      value: 'your-password',
    },
  ],
};
const user = await AuthProvider.auth('email', authData);
console.log(user);

// 4. Create order with [Orders.createOrder()](/docs/orders/createOrder)
const body = {
  formIdentifier: 'order',
  paymentAccountIdentifier: 'cash',
  formData: [
    {
      type: 'string',
      marker: 'name',
      value: 'Christina Thomas',
    },
  ],
  products: [
    {
      productId: 15,
      quantity: 1,
    },
  ],
};
const orderData = (await Orders.createOrder('orders', body as any).catch(
  (e: any) => e,
)) as any;

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

// 5. Creation of payment session with [Payments.createSession()](/docs/payments/createSession)
const sessionData = await Payments.createSession(
  orderData?.id,
  'session',
).catch((e: any) => e);

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

console.log({ user, sessionData, sessionByOrderId });