Unscheduled payments are a special case of payments. They are used to process payments that are not scheduled in advance, but rather initiated by the merchant at a later point in time. This is useful for scenarios where the payment amount is not known at the time of the initial payment, or where the payment is triggered by an event that occurs after the initial payment.
Like with recurring payments, it is also the way to get payment credentials from the customers, as they are on-session for the first payment. Subsequent unscheduled payments will be processed in the background without a customer on-session.
Request
Find the API documentation for the request here.
The payload for the request is very straightforward and in the simplest case looks like this:
- Commerce encodes amounts in minor units of the respective currency. The example above would be 10.00 EUR.
- The
source.type denotes that the payment will be initiated fully on the front-end, and the card details need to be entered there.
Response
Commerce responds with a HTTP 200 OK and a JSON payload. The payload contains the session ID to handle the action requirement:
This use-case automatically creates payment credentials on file for the customer. The credential_id allows you to refer to the credentials in later actions.
