{"_id":"59a45d447ee621000fc9d3d4","category":{"_id":"59a45d447ee621000fc9d3bc","version":"59a45d437ee621000fc9d3b7","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-07-27T17:33:18.096Z","from_sync":false,"order":4,"slug":"sepa-direct-debit-transactions","title":"SEPA Direct Debit Transactions"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"59a45d437ee621000fc9d3b7","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-08-28T18:13:23.840Z","releaseDate":"2017-08-28T18:13:23.840Z","categories":["59a45d447ee621000fc9d3b8","59a45d447ee621000fc9d3b9","59a45d447ee621000fc9d3ba","59a45d447ee621000fc9d3bb","59a45d447ee621000fc9d3bc","59a45d447ee621000fc9d3bd","59a45d447ee621000fc9d3be","59a45d447ee621000fc9d3bf","59a45d447ee621000fc9d3c0","59a45d447ee621000fc9d3c1","59a45d447ee621000fc9d3c2","59a45d447ee621000fc9d3c3","59a45d447ee621000fc9d3c4","59a45d447ee621000fc9d3c5","59a45d447ee621000fc9d3c6","59a45d447ee621000fc9d3c7"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.22.1","version_clean":"8976.0.0-XML","version":"8976-XML"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-07-27T17:49:06.767Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","examples":{"codes":[]},"method":"post","auth":"optional","params":[],"url":"/alt-transactions"},"isReference":false,"order":11,"body":"The Create SEPA DD Transaction request performs a transaction (purchase) using the SEPA Direct Debit payment method. Note that the shopper's account is not immediately debited - it takes about 5 to 6 business days for the shopper's bank to approve the charge and for their account to be debited. \n\nFor more information, see the [SEPA Direct Debit](/v1.0/docs/sepa-direct-debit) guide.\n\n<br>\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Contact [merchant support](mailto:\\\"merchants:::at:::bluesnap.com) to have SEPA Direct Debit enabled for your account.\",\n  \"title\": \"Prerequisite: Have SEPA enabled for your account\"\n}\n[/block]\n<a class=\"btn btn-success\" href=\"#section-api-explorer\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\nSend an **[alt-tansaction](doc:alt-transaction)** container, with the following:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`merchant-transaction-id` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;optional\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`soft-descriptor` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;optional\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`amount` &nbsp;&nbsp;&nbsp; *decimal* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`currency` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>&nbsp;&nbsp;&nbsp;value must be **EUR**\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`payer-info` &nbsp;&nbsp;&nbsp; *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F38A00\">**required** if `vaulted-shopper-id` is not sent</span> (see [payer-info](doc:payer-info))\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`vaulted-shopper-id` &nbsp;&nbsp;&nbsp; *integer* &nbsp;&nbsp;&nbsp;<span style=\"color:#F38A00\">**required** if `payer-info` is not sent</span>\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`sepa-direct-debit-transaction` &nbsp;&nbsp;&nbsp; *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span> (see [sepa-direct-debit-transaction](doc:sepa-direct-debit-transaction))\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`authorized-by-shopper` &nbsp;&nbsp;&nbsp; *boolean* &nbsp;&nbsp;&nbsp;<span style=\"color:#F38A00\">**required**</span>&nbsp;&nbsp;&nbsp;value must be **true**\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`transaction-meta-data` &nbsp;&nbsp;&nbsp; *container* &nbsp;&nbsp;&nbsp;optional (see [transaction-meta-data](doc:transaction-meta-data))\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`transaction-fraud-info` &nbsp;&nbsp;&nbsp; *container* &nbsp;&nbsp;&nbsp;optional (see [transaction-fraud-info](doc:transaction-fraud-info))\n\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the request properties plus these additions:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`transaction-id`\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`vaulted-shopper-id`\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`processing-info`&nbsp;&nbsp;&nbsp;(see [processing-info](doc:processing-info))\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`fraud-result-info`&nbsp;&nbsp;&nbsp;(see [fraud-result-info](doc:fraud-result-info))\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <sepa-direct-debit-transaction>\\n    <iban>DE09100100101234567893</iban>\\n  </sepa-direct-debit-transaction>\\n  <payer-info>\\n    <first-name>John</first-name>\\n    <last-name>Doe</last-name>\\n  </payer-info>\\n  <amount>9.65</amount>\\n  <currency>EUR</currency>\\n  <soft-descriptor>ABC COMPANY</soft-descriptor>\\n  <authorized-by-shopper>true</authorized-by-shopper>\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"Create SEPA DD Transaction: Basic with payer info\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <sepa-direct-debit-transaction/>\\n  <vaulted-shopper-id>21786355</vaulted-shopper-id>\\n   <amount>100.00</amount>\\n   <currency>EUR</currency>\\n   <soft-descriptor>ABC COMPANY</soft-descriptor>\\n   <authorized-by-shopper>true</authorized-by-shopper>\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"with vaulted shopper with one saved account\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <sepa-direct-debit-transaction>\\n    <iban-first-four>DE09</iban-first-four>\\n    <iban-last-four>7893</iban-last-four>\\n  </sepa-direct-debit-transaction>\\n  <vaulted-shopper-id>19557478</vaulted-shopper-id>\\n  <amount>100.00</amount>\\n  <currency>EUR</currency>\\n  <soft-descriptor>ABC COMPANY</soft-descriptor>\\n  <authorized-by-shopper>true</authorized-by-shopper>\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"with vaulted shopper with multiple saved accounts\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n    <transaction-id>1011189089</transaction-id>\\n    <soft-descriptor>ABC COMPANY</soft-descriptor>\\n    <amount>9.65</amount>\\n    <currency>EUR</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n    </payer-info>\\n    <vaulted-shopper-id>21781957</vaulted-shopper-id>\\n    <sepa-direct-debit-transaction>\\n        <iban-first-four>DE09</iban-first-four>\\n        <iban-last-four>7893</iban-last-four>\\n        <mandate-id>Ooo153451</mandate-id>\\n        <mandate-date>01-Aug-17</mandate-date>\\n        <pre-notification-text>The amount of 9.65 EUR will be collected using SEPA Direct Debit with Mandate Ooo153451 from your bank account IBAN DE09XXXXXX7893 in the next few days. Please ensure sufficient funds in your account.</pre-notification-text>\\n        <pre-notification-translation-ref>https://sandbox.bluesnap.com/services/2/translations/sepa/prenotification?transactionid=1011189089</pre-notification-translation-ref>\\n    </sepa-direct-debit-transaction>\\n    <processing-info>\\n        <processing-status>PENDING</processing-status>\\n    </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"Create SEPA DD Transaction: 200 OK - Basic with payer info\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n    <transaction-id>38490478</transaction-id>\\n    <soft-descriptor>ABC COMPANY</soft-descriptor>\\n    <amount>100.00</amount>\\n    <currency>EUR</currency>\\n    <vaulted-shopper-id>21786355</vaulted-shopper-id>\\n    <sepa-direct-debit-transaction>\\n        <iban-first-four>DE09</iban-first-four>\\n        <iban-last-four>7893</iban-last-four>\\n        <mandate-id>BS141932</mandate-id>\\n        <mandate-date>29-Jun-17</mandate-date>\\n        <pre-notification-text>The amount of 100.00 EUR will be collected using SEPA Direct Debit with Mandate BS141932 from your bank account IBAN DE09XXXXXX7893 in the next few days. Please ensure sufficient funds in your account.</pre-notification-text>\\n        <pre-notification-translation-ref>https://sandbox.bluesnap.com/services/2/translations/sepa/prenotification?transactionid=38490478</pre-notification-translation-ref>\\n    </sepa-direct-debit-transaction>\\n    <processing-info>\\n        <processing-status>PENDING</processing-status>\\n    </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"200 OK - with vaulted shopper with one saved account\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n    <transaction-id>38490482</transaction-id>\\n    <soft-descriptor>ABC COMPANY</soft-descriptor>\\n    <amount>100.00</amount>\\n    <currency>EUR</currency>\\n    <vaulted-shopper-id>19557478</vaulted-shopper-id>\\n    <sepa-direct-debit-transaction>\\n        <iban-first-four>DE09</iban-first-four>\\n        <iban-last-four>7893</iban-last-four>\\n        <mandate-id>BS141936</mandate-id>\\n        <mandate-date>29-Jun-17</mandate-date>\\n        <pre-notification-text>The amount of 100.00 EUR will be collected using SEPA Direct Debit with Mandate BS141936 from your bank account IBAN DE09XXXXXX7893 in the next few days. Please ensure sufficient funds in your account.</pre-notification-text>\\n        <pre-notification-translation-ref>https://sandbox.bluesnap.com/services/2/translations/sepa/prenotification?transactionid=38490482</pre-notification-translation-ref>\\n    </sepa-direct-debit-transaction>\\n    <processing-info>\\n        <processing-status>PENDING</processing-status>\\n    </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"200 OK - with vaulted shopper with multiple saved accounts\"\n    }\n  ]\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Example Descriptions\nFor details about the above examples, see:\n* [Create basic SEPA DD transaction with payer info](#section-create-basic-sepa-dd-transaction-with-payer-info)\n* [Create SEPA DD transaction with vaulted shopper with one saved account](#section-create-sepa-dd-transaction-with-vaulted-shopper-with-one-saved-account)\n* [Create SEPA DD transaction with vaulted shopper with multiple saved accounts](#section-create-sepa-dd-transaction-with-vaulted-shopper-with-multiple-saved-accounts)\n\n###Create basic SEPA DD Transaction with payer info\nThis example shows a basic Create SEPA DD Transaction request with a new shopper. For all SEPA DD transactions, you must collect a [mandate acceptance](/v1.0/docs/sepa-direct-debit#section-step-1-collect-a-mandate-acceptance-from-your-shopper) from the shopper, authorizing \nthe funds to be pulled from their account. Include the `authorized-by-shopper` property with the value set to **true** to indicate that you have obtained the shopper's permission.\n\nA successful response from BlueSnap will include a `mandate-id` and `mandate-date`, whose values identify the shopper's mandate acceptance and the date on which the mandate was accepted, respectively. These two values must be displayed on the post-checkout page, the pre-notification email, and the receipt email. \n\nAdditionally, the response will contain `pre-notification-text` - the standard text (in English) that you must display in the pre-notification email - and `pre-notification-translation-ref` - [Get Pre-Notification Text](/v4.0/docs/get-pre-notification-text) endpoint to obtain text in another language. \n\n###Create SEPA DD Transaction with vaulted shopper with one saved account\nTo perform a Create SEPA DD Transaction with an existing vaulted shopper with one saved bank account, you'll include the `vaulted-shopper-id` property within the **[alt-transaction](doc:alt-transaction)** object in your request. The `sepa-direct-debit-transaction` property can be left empty, as shown in the example. \n\n###Create SEPA DD Transaction with vaulted shopper with multiple saved accounts\nTo perform a Create SEPA DD Transaction request with an existing vaulted shopper with multiple saved bank accounts, you'll include the `vaulted-shopper-id` property within the **[alt-transaction](doc:alt-transaction)** object in your request. Additionally, you'll specify the shopper's bank account by including `iban-first-four` and `iban-last-four` within the `seba-direct-debit-transaction` property. \n\nThe above example includes an existing vaulted shopper with ID 19557478, and their bank account is specified by the first four characters (DE09) and last four characters (7893) of the IBAN. \n\n<br>\n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##API Explorer\nTo test out a call, enter the request content below and then click **Try it!**\n\n**Tip**: Use the JSON code below as a starting point. You can enter different parameters to see how your test scenario would work. *The request headers, including authorization, are already built in for you in this test area, so you should not include them here.*\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <sepa-direct-debit-transaction>\\n    <iban>DE09100100101234567893</iban>\\n  </sepa-direct-debit-transaction>\\n  <payer-info>\\n    <first-name>John</first-name>\\n    <last-name>Doe</last-name>\\n  </payer-info>\\n  <amount>9.65</amount>\\n  <currency>EUR</currency>\\n  <soft-descriptor>ABC COMPANY</soft-descriptor>\\n  <authorized-by-shopper>true</authorized-by-shopper>\\n</alt-transaction>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"create-sepa-dd-transaction","type":"post","title":"Create SEPA DD Transaction"}

Payment API (XML)

Card Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

postCreate SEPA DD Transaction

Definition

{{ api_url }}{{ page_api_url }}

Documentation

The Create SEPA DD Transaction request performs a transaction (purchase) using the SEPA Direct Debit payment method. Note that the shopper's account is not immediately debited - it takes about 5 to 6 business days for the shopper's bank to approve the charge and for their account to be debited.

For more information, see the SEPA Direct Debit guide.


Prerequisite: Have SEPA enabled for your account

Contact merchant support to have SEPA Direct Debit enabled for your account.

Try it in the API Explorer

Request Content

Send an alt-tansaction container, with the following:

      merchant-transaction-id     string    optional

      soft-descriptor     string    optional

      amount     decimal    required

      currency     string    required   value must be EUR

      payer-info     container    required if vaulted-shopper-id is not sent (see payer-info)

      vaulted-shopper-id     integer    required if payer-info is not sent

      sepa-direct-debit-transaction     container    required (see sepa-direct-debit-transaction)

      authorized-by-shopper     boolean    required   value must be true

      transaction-meta-data     container    optional (see transaction-meta-data)

      transaction-fraud-info     container    optional (see transaction-fraud-info)

Response Details

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

      transaction-id

      vaulted-shopper-id

      processing-info   (see processing-info)

      fraud-result-info   (see fraud-result-info)

Examples

Request Examples

Create SEPA DD Transaction: Basic with payer info
with vaulted shopper with one saved account
with vaulted shopper with multiple saved accounts
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">
  <sepa-direct-debit-transaction>
    <iban>DE09100100101234567893</iban>
  </sepa-direct-debit-transaction>
  <payer-info>
    <first-name>John</first-name>
    <last-name>Doe</last-name>
  </payer-info>
  <amount>9.65</amount>
  <currency>EUR</currency>
  <soft-descriptor>ABC COMPANY</soft-descriptor>
  <authorized-by-shopper>true</authorized-by-shopper>
</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">
  <sepa-direct-debit-transaction/>
  <vaulted-shopper-id>21786355</vaulted-shopper-id>
   <amount>100.00</amount>
   <currency>EUR</currency>
   <soft-descriptor>ABC COMPANY</soft-descriptor>
   <authorized-by-shopper>true</authorized-by-shopper>
</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">
  <sepa-direct-debit-transaction>
    <iban-first-four>DE09</iban-first-four>
    <iban-last-four>7893</iban-last-four>
  </sepa-direct-debit-transaction>
  <vaulted-shopper-id>19557478</vaulted-shopper-id>
  <amount>100.00</amount>
  <currency>EUR</currency>
  <soft-descriptor>ABC COMPANY</soft-descriptor>
  <authorized-by-shopper>true</authorized-by-shopper>
</alt-transaction>'

Response Examples

Create SEPA DD Transaction: 200 OK - Basic with payer info
200 OK - with vaulted shopper with one saved account
200 OK - with vaulted shopper with multiple saved accounts
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
    <transaction-id>1011189089</transaction-id>
    <soft-descriptor>ABC COMPANY</soft-descriptor>
    <amount>9.65</amount>
    <currency>EUR</currency>
    <payer-info>
        <first-name>John</first-name>
        <last-name>Doe</last-name>
    </payer-info>
    <vaulted-shopper-id>21781957</vaulted-shopper-id>
    <sepa-direct-debit-transaction>
        <iban-first-four>DE09</iban-first-four>
        <iban-last-four>7893</iban-last-four>
        <mandate-id>Ooo153451</mandate-id>
        <mandate-date>01-Aug-17</mandate-date>
        <pre-notification-text>The amount of 9.65 EUR will be collected using SEPA Direct Debit with Mandate Ooo153451 from your bank account IBAN DE09XXXXXX7893 in the next few days. Please ensure sufficient funds in your account.</pre-notification-text>
        <pre-notification-translation-ref>https://sandbox.bluesnap.com/services/2/translations/sepa/prenotification?transactionid=1011189089</pre-notification-translation-ref>
    </sepa-direct-debit-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">
    <transaction-id>38490478</transaction-id>
    <soft-descriptor>ABC COMPANY</soft-descriptor>
    <amount>100.00</amount>
    <currency>EUR</currency>
    <vaulted-shopper-id>21786355</vaulted-shopper-id>
    <sepa-direct-debit-transaction>
        <iban-first-four>DE09</iban-first-four>
        <iban-last-four>7893</iban-last-four>
        <mandate-id>BS141932</mandate-id>
        <mandate-date>29-Jun-17</mandate-date>
        <pre-notification-text>The amount of 100.00 EUR will be collected using SEPA Direct Debit with Mandate BS141932 from your bank account IBAN DE09XXXXXX7893 in the next few days. Please ensure sufficient funds in your account.</pre-notification-text>
        <pre-notification-translation-ref>https://sandbox.bluesnap.com/services/2/translations/sepa/prenotification?transactionid=38490478</pre-notification-translation-ref>
    </sepa-direct-debit-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">
    <transaction-id>38490482</transaction-id>
    <soft-descriptor>ABC COMPANY</soft-descriptor>
    <amount>100.00</amount>
    <currency>EUR</currency>
    <vaulted-shopper-id>19557478</vaulted-shopper-id>
    <sepa-direct-debit-transaction>
        <iban-first-four>DE09</iban-first-four>
        <iban-last-four>7893</iban-last-four>
        <mandate-id>BS141936</mandate-id>
        <mandate-date>29-Jun-17</mandate-date>
        <pre-notification-text>The amount of 100.00 EUR will be collected using SEPA Direct Debit with Mandate BS141936 from your bank account IBAN DE09XXXXXX7893 in the next few days. Please ensure sufficient funds in your account.</pre-notification-text>
        <pre-notification-translation-ref>https://sandbox.bluesnap.com/services/2/translations/sepa/prenotification?transactionid=38490482</pre-notification-translation-ref>
    </sepa-direct-debit-transaction>
    <processing-info>
        <processing-status>PENDING</processing-status>
    </processing-info>
</alt-transaction>

Back to Top

Example Descriptions

For details about the above examples, see:

Create basic SEPA DD Transaction with payer info

This example shows a basic Create SEPA DD Transaction request with a new shopper. For all SEPA DD transactions, you must collect a mandate acceptance from the shopper, authorizing
the funds to be pulled from their account. Include the authorized-by-shopper property with the value set to true to indicate that you have obtained the shopper's permission.

A successful response from BlueSnap will include a mandate-id and mandate-date, whose values identify the shopper's mandate acceptance and the date on which the mandate was accepted, respectively. These two values must be displayed on the post-checkout page, the pre-notification email, and the receipt email.

Additionally, the response will contain pre-notification-text - the standard text (in English) that you must display in the pre-notification email - and pre-notification-translation-ref - Get Pre-Notification Text endpoint to obtain text in another language.

Create SEPA DD Transaction with vaulted shopper with one saved account

To perform a Create SEPA DD Transaction with an existing vaulted shopper with one saved bank account, you'll include the vaulted-shopper-id property within the alt-transaction object in your request. The sepa-direct-debit-transaction property can be left empty, as shown in the example.

Create SEPA DD Transaction with vaulted shopper with multiple saved accounts

To perform a Create SEPA DD Transaction request with an existing vaulted shopper with multiple saved bank accounts, you'll include the vaulted-shopper-id property within the alt-transaction object in your request. Additionally, you'll specify the shopper's bank account by including iban-first-four and iban-last-four within the seba-direct-debit-transaction property.

The above example includes an existing vaulted shopper with ID 19557478, and their bank account is specified by the first four characters (DE09) and last four characters (7893) of the IBAN.


Back to Top

API Explorer

To test out a call, enter the request content below and then click Try it!

Tip: Use the JSON code below as a starting point. You can enter different parameters to see how your test scenario would work. The request headers, including authorization, are already built in for you in this test area, so you should not include them here.

XML
<alt-transaction xmlns="http://ws.plimus.com">
  <sepa-direct-debit-transaction>
    <iban>DE09100100101234567893</iban>
  </sepa-direct-debit-transaction>
  <payer-info>
    <first-name>John</first-name>
    <last-name>Doe</last-name>
  </payer-info>
  <amount>9.65</amount>
  <currency>EUR</currency>
  <soft-descriptor>ABC COMPANY</soft-descriptor>
  <authorized-by-shopper>true</authorized-by-shopper>
</alt-transaction>

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}