Pay Multiple Invoices
Pay multiple invoices with multiple succeeded payment intents.
Use case: Batch payment processing for multiple subscriptions created in a single checkout.
This endpoint is called by the checkout flow after payment intents are confirmed.
Requirements:
- All payment_intent_ids must be in SUCCEEDED status
- All payment intents must belong to the same customer
- All invoices must use the same currency
Behavior:
- Matches payment intents to invoices (exact amount first, then sorted)
- Marks each invoice as PAID using its corresponding processor attempt
- Activates subscriptions linked to paid invoices (INCOMPLETE → ACTIVE)
- Handles partial failures gracefully (continues processing remaining invoices)
Returns detailed outcome for each invoice including:
- Invoice status and ID
- Subscription status and ID (if applicable)
- Processor attempt details
- Success/failure status with error messages
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
account_id
Request
This endpoint expects an object.
account_id
customer_id
payment_intent_ids
invoice_ids
Response
Successful Response
outcomes
total_processed
total_succeeded
total_failed
overall_success
Errors
422
Unprocessable Entity Error