Fill gaps from assistant conversations: wallet-only invoice payment

[mintlify]

Summary

Documents how to record a wallet-only payment against an invoice, closing a recurring assistant gap where users asked whether they could bypass the card-first flow and deduct from a wallet directly (e.g. for add-on charges).

Changes

• Added a Record a wallet-only payment against an invoice subsection to docs/subscriptions/record-payment.mdx under the API Reference section.
• Explains POST /v1/payments with payment_method_type: "CREDITS" and destination_type: "INVOICE", including auto-selection when payment_method_id is omitted and the role of process_payment.
• Notes the constraints (active wallet, sufficient balance, allowed_price_types must cover invoice charges) and calls out that this is distinct from the card-first subscription/renewal flows.
• Includes a worked example for applying wallet credits to an add-on invoice.

Context

Assistant conversations in the review window repeatedly asked how to deduct an add-on charge directly from the wallet without going through card payment. Verified against internal/ee/service/payment.go and internal/ee/service/payment_processor.go in the backend, and against CreatePaymentRequest / PaymentMethodType in api-reference/openapi.json.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
flexprice	🟢 Ready	View Preview	Aug 14, 2026, 5:11 AM