API BasicsPayment APIEmbedded PaymentsReporting & ToolsSupport GuidesBlueSnap.com
Top of Section

Create Sofort Transaction

📘

Coming soon!

Watch for Klarna to replace Sofort.

The Create Sofort Transaction request performs a transaction using the Sofort payment method.

Request Content

Send an alt-transaction object, with the following:

PropertyTypeRequired
amountdecimalrequired
currencystringrequired, must be a supported currency
merchant-transaction-idstringoptional
payer-infoobjectrequired for a new shopper (see payerInfo)
product-descriptionstringoptional
sofort-transactionobjectrequired (see sofort-transaction)
transaction-meta-dataobjectoptional (see transaction-meta-data)
vaulted-shopper-idintegerrequired for a vaulted shopper

The vaulted shopper's saved country must be supported by Sofort.
vendors-infoobjectoptional (see vendors-info)

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:

PropertyNotes
fraud-result-info(see fraud-result-info)
processing-info(see processing-info)
vaulted-shopper-id

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&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000209219850000100001&#x26;MAC&#x3d;1t&#x25;2BHU&#x25;2BnF31pGekoVtt7Rpu5IXvapG3EI6AKpgz7eBYo&#x25;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&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000209225050000100001&#x26;MAC&#x3d;C0giPlQoDFY54kvnkpcUfIFOJI0mCmYzNqlrBDR51y4&#x25;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&#x3a;&#x2f;&#x2f;eu.gcsip.nl&#x2f;orb&#x2f;orb&#x3f;ACTION&#x3d;DO_START&#x26;REF&#x3d;000000410000209217250000100001&#x26;MAC&#x3d;KgD72WCtT&#x25;2FlPlAwbMtKWD7iK6ekRxezMxRX3pskHXPs&#x25;3D</sofort-url>
    <order-id>20921725</order-id>
  </sofort-transaction>
  <processing-info>
    <processing-status>PENDING</processing-status>
  </processing-info>
</alt-transaction>