Integration Checklist

To start using the Dintero Checkout in your own website, you need to create an API Client via Dintero Backoffice.

Step by step-guide

First, log into Backoffice, then follow this intercative slide-show:

Check out how to create a session for the next steps in your integration.

Integrate these API endpoints
- Authenticate POST /v1/accounts/{oid}/auth/token
- Create session POST /v1/sessions-profile
- Capture transaction POST /v1/transactions/{id}/capture
- Void transaction POST /v1/transactions/{id}/void
- Refund transaction POST /v1/transactions/{id}/refund
Handle redirect and callback
- Callback, see url.callback_url POST /v1/sessions-profile
- Redirect, see url.return_url POST /v1/sessions-profile
- Redirect is not guaranteed, so it's important to handle both.
- The order of callbacks and redirects are not guaranteed, so handle the possibility of both coming first.
- Open for traffic from callback Validating callbacks
Important details when creating session
- Prefer checkout profiles for configuring sessions
- Each item in order.items should contain an unique line_id.
- Each item in order.items should contain the vat percentage.
- amount = amount_without_vat + vat_amount.
Capturing
- Make sure to include all the captured items in the call to /capture, also the shipping option.
- When capturing Collector payments, capture full item lines.
Refunding
- Include the details of the items being refunded.
If using Checkout Express
- Handle shipping address callback for updating shipping options when shipping address changes (optional)
- Handle discount code callback to validate discount codes (optional)
Other
- Integrate optional headers for better tracking