OpenMax
免费试用

Apps API · Billing Payment Methods

Billing Payment Methods: 2 个接口

← 全部分组

GET /api/v1/billing/payment-methods

List payment methods

权限(scope): billing:payment_method:read · 调用方式: appToken · operationId: list-billing-payment-methods

Required app scope: billing:payment_method:read.

Lists the caller org's payment methods (including pending_setup). Requires org-owner (403 AUTH_FORBIDDEN otherwise). Response wrapped in standard envelope.

参数

名字 位置 类型 必填 说明
payer_ref query string Optional payer reference to scope the list

回包

GET /api/v1/billing/payment-options

Get offered payment methods

权限(scope): billing:subscription:read · 调用方式: appToken · operationId: get-billing-payment-options

Required app scope: billing:subscription:read.

Returns the payment methods this deployment OFFERS for the given purchase scenario, so clients render the picker from configuration instead of a hardcoded list. This is policy, not capability: an enabled method is one we choose to offer, NOT a guarantee it can be charged (that additionally depends on the price's currency and on whether the payment provider supports the method for it). Disabled entries are returned too, so a client can tell 'withheld' from 'unknown'. Served from this deployment's own configuration — unlike the rest of /billing/*, it stays available even when billing is unavailable on this deployment. Response wrapped in standard envelope.

参数

名字 位置 类型 必填 说明
scenario query string: subscription, credit_pack 是 Purchase scenario: subscription covers first subscribe and plan change; credit_pack covers one-time credit-pack purchases

回包