{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Sofort","type":"basic","slug":"sofort","excerpt":"Learn how to process Sofort transactions with BlueSnap's Payment API.","body":"Sofort is a popular online, real-time banking method in Europe. This payment method enables shoppers to complete their purchases in their bank's portal, giving them greater comfort and security in the checkout process. Sofort is supported in [these countries](https://support.bluesnap.com/docs/sofort#supported-markets). \n\nThis guide covers the following topics: \n* [Requirements](#section-requirements)\n* [Sofort transaction flow](#section-sofort-transaction-flow)\n* [API integrations](#section-api-integrations)\n* [Sandbox testing](#section-sandbox-testing)\n\n# Requirements\nIn your BlueSnap Merchant Portal, [verify Real-Time Bank Transfer has been enabled](https://support.bluesnap.com/docs/payment-method-setup) and is set to **Show**.\n\n# Sofort transaction flow\n\n1. Create a page for your shopper to enter their [personal information](/v8976-JSON/docs/payer-info).    \n\n2. Send a [Create Sofort Transaction](/v8976-JSON/docs/create-sofort-transaction) request to BlueSnap from your server. As part of the required parameters, provide a `returnUrl` where you would like BlueSnap to send your shopper after they complete their purchase. \n\n4. The API response will include `sofortUrl` where you'll need to direct your shopper so they can complete their purchase. \n\n5. Your shopper selects their bank and country. They then enter their bank details and select their account. After they complete their purchase, they get redirected back to your site (to the `returnUrl` address from step 2). You can parse the [query string](#section-return-url-query-string-parameters) of your URL to get the transaction results. \n\n**Note:** The transaction is in pending status until your shopper completes their purchase. At this point, the status changes to approved or failed. \n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n### Return URL query string parameters \nBefore redirecting your shopper to your return URL, BlueSnap appends the query string with the following parameters. You can parse the query string to get the transaction results and determine which page to display to the shopper. For example, if the transaction was successful, you can display a confirmation page. \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"`STATUS`\",\n    \"h-0\": \"Parameter Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-1\": \"string\",\n    \"0-2\": \"The status of the transaction. \\n\\nPossible values: \\n\\n- `SUCCESS`\\n- `FAIL`\\n- `PENDING`\",\n    \"1-0\": \"`ORDER-ID`\",\n    \"1-1\": \"integer\",\n    \"1-2\": \"BlueSnap identifier for the order.\",\n    \"2-0\": \"`TRANSACTION-ID`\",\n    \"2-1\": \"string\",\n    \"2-2\": \"BlueSnap identifier for the approved transaction. Only returned if `STATUS` is `SUCCESS`\",\n    \"3-0\": \"`MTI`\",\n    \"3-1\": \"string\",\n    \"3-2\": \"The Merchant Transaction ID. Only returned if the value was included in the [Create Sofort Transaction](/v8976-JSON/docs/create-sofort-transaction) request.\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]\n# API integrations\nSofort transactions are supported in BlueSnap's Payment API. See: \n\n* [Create Sofort Transaction](/v8976-JSON/docs/create-sofort-transaction)\n* [Retrieve Sofort Transaction](/v8976-JSON/docs/retrieve-sofort-transaction)\n\n# Sandbox testing \nYou can use the following test cases to test various scenarios in Sandbox via the [Create Sofort Transaction](/v8976-JSON/docs/create-sofort-transaction) request. \n\n[block:parameters]\n{\n  \"data\": {\n    \"3-1\": \"The initial transaction status is `PENDING`, then changes to `FAIL` within 15 minutes.\",\n    \"h-0\": \"Test Case\",\n    \"h-1\": \"Result\",\n    \"0-0\": \"Append your `firstName` value with **_APPROVE**. \\nFor example: `Jane_APPROVE`\",\n    \"0-1\": \"The transaction status is `SUCCESS`.\",\n    \"1-0\": \"Append your `firstName` value with **_REJECT**. \\nFor example: `Jane_REJECT`\",\n    \"1-1\": \"The transaction status is `FAIL`.\",\n    \"2-0\": \"Append your `firstName` value with **_DELAYAP**. \\n\\nFor example: `Jane_DELAYAP`\",\n    \"2-1\": \"The initial transaction status is `PENDING`, then changes to `SUCCESS` within 15 minutes.\",\n    \"3-0\": \"Append your `firstName` value with **_DELAYRJ**. \\n\\nFor example: `Jane_DELAYRJ`\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","updates":[],"order":28,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"622623052699060013831de0","createdAt":"2020-12-01T17:41:47.154Z","user":"5ea72d649148ff00653f6bbc","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Guides","slug":"topics","order":7,"from_sync":false,"reference":false,"_id":"622623052699060013831da1","version":"622623052699060013831de5","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-11-03T20:45:01.593Z","__v":0},"version":{"version":"8976-Basics","version_clean":"8976.0.0-Basics","codename":"3.41 Release","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["622623052699060013831d9c","622623052699060013831d9d","622623052699060013831d9e","6183ed028202aa001610248b","622623052699060013831d9f","622623052699060013831da0","5beb278ac442ab0213f00990","622623052699060013831da1","5c3f542c12c4ac004bc51718","6183ed028202aa001610248f","5df806ccecebde0059f17225","5dfa8a8f340c2b007418eb8a","622623052699060013831da2","5e597199fd2b0200117c2c1c"],"_id":"622623052699060013831de5","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6183ed028202aa00161024e9","createdAt":"2018-04-23T14:36:48.535Z","releaseDate":"2018-04-23T14:36:48.535Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}

Quickstart

API Usage

Mobile

SDKs

Reference

Guides

Sofort

Learn how to process Sofort transactions with BlueSnap's Payment API.

Sofort is a popular online, real-time banking method in Europe. This payment method enables shoppers to complete their purchases in their bank's portal, giving them greater comfort and security in the checkout process. Sofort is supported in these countries.

This guide covers the following topics:

Requirements

In your BlueSnap Merchant Portal, verify Real-Time Bank Transfer has been enabled and is set to Show.

Sofort transaction flow

  1. Create a page for your shopper to enter their personal information.

  2. Send a Create Sofort Transaction request to BlueSnap from your server. As part of the required parameters, provide a returnUrl where you would like BlueSnap to send your shopper after they complete their purchase.

  3. The API response will include sofortUrl where you'll need to direct your shopper so they can complete their purchase.

  4. Your shopper selects their bank and country. They then enter their bank details and select their account. After they complete their purchase, they get redirected back to your site (to the returnUrl address from step 2). You can parse the query string of your URL to get the transaction results.

Note: The transaction is in pending status until your shopper completes their purchase. At this point, the status changes to approved or failed.

Back to Top

Return URL query string parameters

Before redirecting your shopper to your return URL, BlueSnap appends the query string with the following parameters. You can parse the query string to get the transaction results and determine which page to display to the shopper. For example, if the transaction was successful, you can display a confirmation page.

Parameter Name
Type
Description

STATUS

string

The status of the transaction.

Possible values:

  • SUCCESS
  • FAIL
  • PENDING

ORDER-ID

integer

BlueSnap identifier for the order.

TRANSACTION-ID

string

BlueSnap identifier for the approved transaction. Only returned if STATUS is SUCCESS

MTI

string

The Merchant Transaction ID. Only returned if the value was included in the Create Sofort Transaction request.

API integrations

Sofort transactions are supported in BlueSnap's Payment API. See:

Sandbox testing

You can use the following test cases to test various scenarios in Sandbox via the Create Sofort Transaction request.

Test Case
Result

Append your firstName value with _APPROVE.
For example: Jane_APPROVE

The transaction status is SUCCESS.

Append your firstName value with _REJECT.
For example: Jane_REJECT

The transaction status is FAIL.

Append your firstName value with _DELAYAP.

For example: Jane_DELAYAP

The initial transaction status is PENDING, then changes to SUCCESS within 15 minutes.

Append your firstName value with _DELAYRJ.

For example: Jane_DELAYRJ

The initial transaction status is PENDING, then changes to FAIL within 15 minutes.