Chuyển đến nội dung chính
POST
/
payments
JavaScript
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const payment = await client.payments.create({
  billing: { country: 'AF' },
  customer: { customer_id: 'customer_id' },
  product_cart: [{ product_id: 'product_id', quantity: 0 }],
});

console.log(payment.payment_id);
{
  "client_secret": "<string>",
  "customer": {
    "customer_id": "<string>",
    "email": "<string>",
    "name": "<string>",
    "metadata": {},
    "phone_number": "<string>"
  },
  "metadata": {},
  "payment_id": "<string>",
  "total_amount": 1,
  "discount_id": "<string>",
  "expires_on": "2023-11-07T05:31:56Z",
  "payment_link": "<string>",
  "product_cart": [
    {
      "product_id": "<string>",
      "quantity": 1,
      "amount": 123
    }
  ]
}
API đã ngừng sử dụng: API này sẽ sớm bị ngừng sử dụng. Chúng tôi khuyên bạn nên sử dụng Phiên Thanh Toán thay thế, cung cấp một API mạnh mẽ và tùy chỉnh hơn để tạo liên kết thanh toán cho các khoản thanh toán một lần và đăng ký.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Nội dung

application/json
​
billing
object
bắt buộc

Billing address details for the payment

​
customer
Attach Existing Customer · object
bắt buộc

Customer information for the payment

​
product_cart
One-Time Product Cart Item · object[]
bắt buộc

List of products in the cart. Must contain at least 1 and at most 100 items.

​
allowed_payment_method_types
enum<string>[] | null

List of payment methods allowed during checkout.

Customers will never see payment methods that are not in this list. However, adding a method here does not guarantee customers will see it. Availability still depends on other factors (e.g., customer location, merchant settings).

Tùy chọn có sẵn:
credit,
debit,
upi_collect,
upi_intent,
apple_pay,
cashapp,
google_pay,
multibanco,
bancontact_card,
eps,
ideal,
przelewy24,
paypal,
affirm,
klarna,
sepa,
ach,
amazon_pay,
afterpay_clearpay
​
billing_currency
null | enum<string>

Fix the currency in which the end customer is billed. If Dodo Payments cannot support that currency for this transaction, it will not proceed

Tùy chọn có sẵn:
AED,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BWP,
BYN,
BZD,
CAD,
CHF,
CLP,
CNY,
COP,
CRC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SEK,
SGD,
SHP,
SLE,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SZL,
THB,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW
​
discount_code
string | null

Discount Code to apply to the transaction

​
force_3ds
boolean | null

Override merchant default 3DS behaviour for this payment

​
metadata
object

Additional metadata associated with the payment. Defaults to empty if not provided.

​
payment_link
boolean | null

Whether to generate a payment link. Defaults to false if not specified.

​
payment_method_id
string | null

Optional payment method ID to use for this payment. If provided, customer_id must also be provided. The payment method will be validated for eligibility with the payment's currency.

​
redirect_immediately
boolean

If true, redirects the customer immediately after payment completion False by default

​
return_url
string | null

Optional URL to redirect the customer after payment. Must be a valid URL if provided.

​
short_link
boolean | null

If true, returns a shortened payment link. Defaults to false if not specified.

​
show_saved_payment_methods
boolean

Display saved payment methods of a returning customer False by default

​
tax_id
string | null

Tax ID in case the payment is B2B. If tax id validation fails the payment creation will fail

Phản hồi

One Time payment successfully initiated

​
client_secret
string
bắt buộc

Client secret used to load Dodo checkout SDK NOTE : Dodo checkout SDK will be coming soon

​
customer
object
bắt buộc

Limited details about the customer making the payment

​
metadata
object
bắt buộc

Additional metadata associated with the payment

​
payment_id
string
bắt buộc

Unique identifier for the payment

​
total_amount
integer<int32>
bắt buộc

Total amount of the payment in smallest currency unit (e.g. cents)

Phạm vi bắt buộc: x >= 0
​
discount_id
string | null

The discount id if discount is applied

​
expires_on
string<date-time> | null

Expiry timestamp of the payment link

​
payment_link
string | null

Optional URL to a hosted payment page

​
product_cart
One-Time Product Cart Item · object[] | null

Optional list of products included in the payment