Create and Authorise Order
A 3-step recipe with Tamara. We can help you get access.
Recipe · 3 steps
Create and Authorise Order
with Tamara
Create a Tamara checkout session and authorise the order after it is approved.
- Create a hosted checkout session so Tamara can collect payment and complete the BNPL or Pay-Now flow with the consumer.
- Read the order Tamara created so the workflow can inspect its current status before attempting to authorise it.
- Transition the approved order to authorised. Should be called on receipt of the order_approved webhook; uncaptured orders auto-capture after 21 days.
What you'll need to have ready
- merchantToken: Tamara-issued merchant API bearer token.
- orderReferenceId: The merchant's own reference id for the order.
- orderNumber: Optional human-facing order number.
- totalAmount: Money object with amount and currency for the order total.
- description: Short description of the order (max 256 chars).
- countryCode: Two-letter country code (SA, AE, BH, KW, OM).
- paymentType: PAY_BY_INSTALMENTS or PAY_NOW.
- instalments: Optional number of instalments (2-24).
- items: Line items in the order.
- consumer: Consumer first_name, last_name, phone_number and optional details.
- shippingAddress: Shipping address for the order.
- taxAmount: Money object for the total tax amount.
For your developer
Arazzo workflow tamara:create-and-authorise-order, 3 operations: createCheckoutSession → getOrderDetails → authoriseOrder. Specs on APIs.io.