Retrieve Sofort Transaction

📘

Coming soon!

Watch for Klarna to replace Sofort.

This request gets details about a past Sofort transaction.


❗️

Important

The API Explorer Try It! feature does not currently send XML requests to our sandbox environment.

For request and response examples, refer to the Examples section.

Request Content

No content is required in the request body. Enter the relevant IDs in the request URL, as follows:

Retrieve based on Order ID

The order ID can be used to retrieve the transaction at any point. BlueSnap returns the order ID in the Create Sofort Transaction response.

Enter the order-id into the web service URL, in the format:
services/2/alt-transactions/resolve?orderId={order ID}

For example: services/2/alt-transactions/resolve?orderId=18981947

Retrieve based on Transaction ID

If the shopper has completed their purchase (processing-status is success), the transaction will be assigned a transaction ID. BlueSnap provides the transaction ID in your return URL query string.

Enter the transaction-id into the web service URL, in the format:
services/2/alt-transactions/{transaction ID}

For example: services/2/alt-transactions/1034522153

Note: If the shopper has not completed their purchase (processing-status is pending), the transaction will not have a transaction ID yet, so you will need to retrieve based on order ID, or retrieve based on Merchant Transaction ID and Merchant ID.

Retrieve based on Merchant Transaction ID and Merchant ID

Enter the Merchant Transaction ID and Merchant ID into the web service URL, in the format:
services/2/alt-transactions/{merchant transaction ID},{merchant ID}

For example: services/2/alt-transactions/sofort-8202020,500605

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved alt-transaction resource (see alt-transaction).


Examples

Request Examples

curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/resolve?orderId=20922493 \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/1034522167 \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/sofort-1222,500605 \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '

Response Examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
  <amount>42</amount>
  <currency>GBP</currency>
  <payer-info>
    <first-name>John</first-name>
    <last-name>Doe</last-name>
    <country>uk</country>
  </payer-info>
  <vaulted-shopper-id>29896125</vaulted-shopper-id>
  <sofort-transaction>
    <language>en</language>
    <sofort-url>https&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000209224930000100001&#x26;MAC&#x3d;k4cr6oNG&#x25;2FYtDMwfKJWwveKOSA6V3xDS8j0qFWZD7IyA&#x25;3D</sofort-url>
    <order-id>20922493</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">
  <transaction-id>1034522167</transaction-id>
  <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>19588752</vaulted-shopper-id>
  <sofort-transaction>
    <sofort-url>https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000040103510000100001&MAC=86NRCBH6IDTNSs1B3UM8khLsRUIOYmYNU%2FV2CziYA3g%3D</sofort-url>
    <order-id>4010351</order-id>
  </sofort-transaction>
  <processing-info>
    <processing-status>SUCCESS</processing-status>
  </processing-info>
</alt-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
  <merchant-transaction-id>sofort-1222</merchant-transaction-id>
  <amount>50</amount>
  <currency>EUR</currency>
  <payer-info>
    <first-name>John</first-name>
    <last-name>Doe</last-name>
    <country>de</country>
  </payer-info>
  <vaulted-shopper-id>29896253</vaulted-shopper-id>
  <sofort-transaction>
    <language>en</language>
    <sofort-url>https&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000209225010000100001&#x26;MAC&#x3d;T8Xk9fqXiIlBNoEZKEVceB82rTUWBS&#x25;2BsHQbhZAHLlmU&#x25;3D</sofort-url>
    <order-id>20922501</order-id>
  </sofort-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>

Back to Top

API Explorer (for request based on Order ID)

To test out a call, enter an existing order ID (e.g. 20922493) in the orderId field; this automatically inserts the ID into the request URL. Then, click Try it!.

Language
Authorization
Header
Click Try It! to start a request and see the response here!