post https://sandbox.bluesnap.com/services/2/alt-transactions
The Create Sofort Transaction request performs a transaction using the Sofort payment method.
Tip
You can test out a request that hits our sandbox in real-time. Follow the instructions here to use the "Try It!" feature on the right side.
Request Content
Send an alt-transaction object, with the following:
| Property | Type | Required |
|---|---|---|
amount | decimal | required |
currency | string | required, must be a supported currency |
product-description | string | optional |
sofort-transaction | object | required (see sofort-transaction) |
payer-info | object | required for a new shopper (see payerInfo) |
vaulted-shopper-id | integer | required for a vaulted shopper The vaulted shopper's saved country must be supported by Sofort. |
vendors-info | object | optional (see vendors-info) |
merchant-transaction-id | string | optional |
transaction-meta-data | object | optional (see transaction-meta-data) |
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:
| Property | Notes |
|---|---|
vaulted-shopper-id | |
processing-info | (see processing-info) |
fraud-result-info | (see fraud-result-info) |
Examples
Request Examples
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>de</country>
</payer-info>
<sofort-transaction>
<return-url>http://www.returnURL.com</return-url>
</sofort-transaction>
</alt-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>GBP</currency>
<vaulted-shopper-id>29896125</vaulted-shopper-id>
<sofort-transaction>
<language>fr</language>
<return-url>http://www.returnURL.com</return-url>
</sofort-transaction>
</alt-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>de</country>
</payer-info>
<sofort-transaction>
<return-url>http://www.returnURL.com</return-url>
</sofort-transaction>
<vendors-info>
<vendor-info>
<vendor-id>837389</vendor-id>
</vendor-info>
</vendors-info>
</alt-transaction>'
Response Examples
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>de</country>
</payer-info>
<vaulted-shopper-id>29896283</vaulted-shopper-id>
<sofort-transaction>
<sofort-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000209219850000100001&MAC=1t%2BHU%2BnF31pGekoVtt7Rpu5IXvapG3EI6AKpgz7eBYo%3D</sofort-url>
<order-id>20921985</order-id>
</sofort-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
<transaction-region>UK</transaction-region>
</processing-info>
</alt-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
<amount>42.00</amount>
<currency>GBP</currency>
<vaulted-shopper-id>29896125</vaulted-shopper-id>
<sofort-transaction>
<language>fr</language>
<sofort-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000209225050000100001&MAC=C0giPlQoDFY54kvnkpcUfIFOJI0mCmYzNqlrBDR51y4%3D</sofort-url>
<order-id>20922505</order-id>
</sofort-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
<vendors-info>
<vendor-info>
<vendor-id>837389</vendor-id>
<commission-percent>30</commission-percent>
</vendor-info>
</vendors-info>
<amount>42.00</amount>
<currency>EUR</currency>
<payer-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<country>de</country>
</payer-info>
<vaulted-shopper-id>29896295</vaulted-shopper-id>
<sofort-transaction>
<sofort-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000209217250000100001&MAC=KgD72WCtT%2FlPlAwbMtKWD7iK6ekRxezMxRX3pskHXPs%3D</sofort-url>
<order-id>20921725</order-id>
</sofort-transaction>
<processing-info>
<processing-status>PENDING</processing-status>
</processing-info>
</alt-transaction>
API Explorer
To test out a basic API request, click the "Try It!" button in the right-hand column to test using the default, pre-populated sample values. To test with your own values, edit the parameter fields below. You'll see them populate in the right-hand column and you can click the "Try It!" button to submit your test request and see a response.