API Client

To start using the Dintero Checkout on your website, you need to create an API Client trough the Dintero Backoffice.

Step by step-guide

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

1. Click on settings.
2. Under API & Integrations click on API clients.
3. Click on Create new API client.
4. Click on Checkout client.
5. Write the URL of your website.
6. Click on Create new API client.
7. Remember to Save the credentials, the Client Secret can not be shown again.
8. Click OK.
9. The Client is now Created.

Using Our Plugin

If you’re using our plugin, most of the technical details below are handled automatically. You can skip the following sections unless you’re customizing the integration or coding it yourself.

For Developers

If you’re handling the integration directly, some of the following steps and details are crucial for a successful setup:

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

More info

• 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