Orders

You can create orders for all purchase types with the order endpoints.

Before you create orders

Create a product in the UI with the product_type for your order. Then create a customer in the API or UI, or using CSV import. For metered or instalment orders, define the amounts for card registration when the initial payment is 0. See card registration amount in the configuration documentation.

Accepting payments

BillPro creates a payment link for a new order and sets its status to pending. Send the payment link to the customer by email, or integrate with the payment link to redirect the customer to the secure checkout. See Integrate with payment links. The payment link renews the checkout when the user clicks on it.

For CardCorp merchant accounts only, when you create the order, you can create a custom checkout to use in an iframe integration. See Integrate with custom checkout and payment iframe. If the user doesn't complete their transaction within 25 minutes, the custom checkout expires. Renew the expired checkout with the Renew Checkout request.

Notifications

When you create an order with the API, BillPro does not send an Order is Ready email with the payment link to the customer. However, it sends payment reminders for all Pending orders. You can change the configuration of payment reminders.

Manage scheduled payments

For orders with recurring payments, you can manage billing events for scheduled payments in the UI and with the API.

Manage subscriptions

For subscriptions, when you manage scheduled payments, you can also change the payment intervals with the API. And you can pause and restart subscriptions with the API.

Cancel orders

In the API, you can cancel instalment, subscription, and metered orders using the Cancel order request. From this request, the API cancels preliminary orders and marks live orders as Complete. Preliminary orders have a status of draft, pending, or rejected. Live orders have a status of active, failed, suspended, paused, or review.

In the UI, you can open the Order Summary and from the actions menu, select Cancel Order or Mark as Complete.

Cancel old pending orders

Regularly cancel old Pending orders in the UI or API. To get a list of pending orders, create an Orders report and filter for the pendingstatus. You can download the report in CSV format.