createOrder

Cập nhật lần cuối: 18/03/2024

Tạo yêu cầu thanh toán.

Parameters

Object object

Property	Type	Required	Description
amount	number	true	Số tiền cần thanh toán
item	Array<Record<String, String>>	true	Thông tin các items thanh toán
desc	string	true	Mô tả giao dịch thanh toán
extradata	any		Thông tin mà đối tác cần gửi thêm Toàn bộ dữ liệu sẽ được Checkout SDK chủ động gửi cho đối tác thanh toán: Đối với ZaloPay: thông qua tham số embedData Đối với MoMo: thông qua tham số extraData Riêng các thông tin như storeName, storeId, orderGroupId, Checkout SDK sẽ gửi trực tiếp qua các trường storeName, storeId, orderGroupId
success	function		Callback function khi gọi api thành công
fail	function		Callback function khi gọi api thất bại

Return Values

Promise <Object data>

Property	Type	Description
orderId	string	Mã đơn hàng của yêu cầu thanh toán vừa tạo

Sample Code

import { Payment } from "zmp-sdk";

// tạo yêu cầu thanh toán 50.000VNĐ
Payment.createOrder({
  desc: "Thanh toán 50.000",
  item: [
    { id: "1", amount: 20000 },
    { id: "2", amount: 30000 },
  ],
  amount: 50000,
  extradata: { // toàn bộ extradata sẽ được truyền qua embedData (ZaloPay) hoặc extraData (MoMo)
    storeName: "Cửa hàng A", // field này sẽ được truyền trực tiếp qua storeName (MoMo)
    storeId: "123", // field này sẽ được truyền trực tiếp qua storeId (MoMo)
    orderGroupId: "345" // field này sẽ được truyền trực tiếp qua orderGroupId (MoMo)
    myTransactionId: "12345678", // transaction id riêng của hệ thống của bạn
    notes: "Đây là giá trị gửi thêm",
  }
  success: (data) => {
    // Tạo đơn hàng thành công
    // Hệ thống tự động chuyển sang trang thanh toán.
    const { orderId } = data;
    console.log(orderId);
  },
  fail: (err) => {
    // Tạo đơn hàng lỗi
    console.log(err);
  },
});

// hoặc
const { orderId } = await Payment.createOrder({
  desc: "Thanh toán 50.000",
  item: [
    { id: "1", amount: 20000 },
    { id: "2", amount: 30000 },
  ],
  amount: 50000,
  fail: (err) => {
    // Tạo đơn hàng lỗi
    console.log(err);
  },
});