The developer.datatrans.com Developer Hub

Welcome to the developer.datatrans.com developer hub. You'll find comprehensive guides and documentation to help you start working with developer.datatrans.com as quickly as possible, as well as support if you get stuck. Let's jump right in!

Split Authorizations

Split Authorizations separates the authorization process in two steps. You can proceed with the transaction first and as a second step, you complete the authorization with an additional request. This method of processing transactions reduces the risk of faulty debiting.

Try Deferred Settlement instead

You can also defer payments by using a so-called deferred settlement. You will find more information in our settling a transaction section of the docs.

Before you get started with split authorizations, please contact us to have your merchant configuration accept split authorizations.

Payment Page Setup

Once you have linked our payment pages and your merchant is configured to allow split authorizations, you can start processing split authorizations. After a transaction has been completed you will receive a transactionId in your webhook that you will need for the final authorization.

Finalizing the Authorization

To finalize any transaction using split authorizations you need to call our authorize-split endpoint. Here you can specify if the transaction should be settled automatically or if you wish to proceed with a deferred settlement.

curl 'https://api.sandbox.datatrans.com/v1/transactions/{{transactionId}}/authorize' \
--header 'Authorization: Basic {{basicAuth}}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"refno": "Test-1234",
	"amount": 100,
	"autoSettle": true
}'

Updated about a month ago

Split Authorizations


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.