---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: MA/checkoutSdk/apis/purchase
title: purchase
---
Gửi thông tin thanh toán.

## Parameters

### Object _object_

| Property | Type     | Required | Description                                                                                                              |
| -------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| amount   | number   | true     | Số tiền cần thanh toán                                                                                                   |
| desc     | string   | true     | Mô tả giao dịch thanh toán                                                                                               |
| method   | string   | true     | Mã phương thức thanh toán. Nếu phương thức được Checkout SDK hỗ trơ, vui lòng tham khảo [tại đây](/docs/MA/checkoutSdk/method) |
| 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 \

| Property     | Type   | Description                                                                                                                                                  |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| orderId      | string | Mã đơn hàng của yêu cầu thanh toán vừa tạo                                                                                                                   |
| messageToken | string | Token dùng để sử dụng tin Mini App. Chi tiết về tin Mini App tham khảo tại đây |

### Error code

Tham khảo tại [đây](/docs/MA/checkoutSdk/errorcodes).

## Sample Code

```jsx
import { CheckoutSDK } from "zmp-sdk/apis";

// tạo yêu cầu thanh toán 50.000VNĐ
CheckoutSDK.purchase({
  desc: "Thanh toán 50.000",
  amount: 50000,
  method: "ZALOPAY_SANDBOX",
  success: (data) => {
    // Tạo đơn hàng thành công
    const { orderId } = data;
    console.log(orderId);
  },
  fail: (err) => {
    // Tạo đơn hàng lỗi
    console.log(err);
  },
});

// hoặc
const purchase = async () => {
  try {
    const { orderId } = await CheckoutSDK.purchase({
      desc: "Thanh toán 50.000",
      amount: 50000,
      method: "ZALOPAY_SANDBOX",
    });
  } catch (error) {
    // xử lý lỗi
    console.log(error);
  }
};
```