创建分类账条目

创建分类账条目以贷记或借记客户的余额

POST /credit-entitlements/{credit_entitlement_id}/balances/{customer_id}/ledger-entries

JavaScript

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 response = await client.creditEntitlements.balances.createLedgerEntry('customer_id', {
  credit_entitlement_id: 'credit_entitlement_id',
  amount: 'amount',
  entry_type: 'credit',
});

console.log(response.id);

201

{
  "amount": "<string>",
  "balance_after": "<string>",
  "balance_before": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "credit_entitlement_id": "<string>",
  "customer_id": "<string>",
  "id": "<string>",
  "is_credit": true,
  "overage_after": "<string>",
  "overage_before": "<string>",
  "grant_id": "<string>",
  "reason": "<string>"
}

授权

Authorization · string · header · 必填

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

路径参数

credit_entitlement_id · string · 必填

Credit Entitlement ID

customer_id · string · 必填

Customer ID

请求体

application/json

Request to create a ledger entry (credit or debit)

amount · string · 必填

Amount to credit or debit

entry_type · enum<string> · 必填

Entry type: credit or debit

可用选项: credit, debit

expires_at · string<date-time> | null

Expiration for credited amount (only for credit type)

idempotency_key · string | null

Idempotency key to prevent duplicate entries

metadata · object

Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500 chars)

Show child attributes

reason · string | null

Human-readable reason for the entry

响应

201

application/json

Ledger entry created successfully

Response for creating a ledger entry

amount · string · 必填

balance_after · string · 必填

balance_before · string · 必填

created_at · string<date-time> · 必填

credit_entitlement_id · string · 必填

customer_id · string · 必填

entry_type · enum<string> · 必填

可用选项: credit, debit

id · string · 必填

is_credit · boolean · 必填

overage_after · string · 必填

overage_before · string · 必填

grant_id · string | null

reason · string | null