{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/alt-transactions","auth":"optional","results":{"codes":[]},"settings":"","examples":{"codes":[]},"method":"post","params":[]},"next":{"description":"","pages":[]},"title":"Create SEPA DD Transaction","type":"endpoint","slug":"create-sepa-dd-transaction","excerpt":"","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](/docs/sepa-direct-debit) guide.\n\n<br>\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Contact [Merchant Support](https://bluesnap.zendesk.com/hc/en-us/requests/new?ticket_form_id=360000127087) 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-transaction](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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`soft-descriptor` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;optional\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`amount` &nbsp;&nbsp;&nbsp; *decimal* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`tax-reference` *string* &nbsp;&nbsp;&nbsp;optional\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`country` &nbsp;&nbsp;&nbsp; *string* &nbsp;&nbsp;&nbsp;optional\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`vendors-info` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F38A00\">**required** if using marketplace vendor(s)</span> (see [vendors-info](doc:vendors-info))\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&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&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&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&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&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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`vaulted-shopper-id`\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`processing-info`&nbsp;&nbsp;&nbsp;(see [processing-info](doc:processing-info))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`fraud-result-info`&nbsp;&nbsp;&nbsp;(see [fraud-result-info](doc:fraud-result-info))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`vendors-info`&nbsp;&nbsp;&nbsp;(see [vendors-info](doc:vendors-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  <country>FR</country>\\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   <country>FR</country>\\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  <country>FR</country>\\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      \"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>12.65</amount>\\n  <currency>EUR</currency>\\n  <tax-reference>048deff0-a285-47e1-bc39-42f79bf0095b</tax-reference>\\n  <country>FR</country>\\n  <soft-descriptor>ABC COMPANY</soft-descriptor>\\n  <authorized-by-shopper>true</authorized-by-shopper>\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"with tax quote\"\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\": \"- 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\": \"- with vaulted shopper with multiple saved accounts\"\n    },\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>12.65</amount>\\n    <currency>EUR</currency>\\n   <tax-reference>048deff0-a285-47e1-bc39-42f79bf0095b</tax-reference>\\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\": \"with tax quote\"\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](/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](/v8976-Tools/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 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]","updates":[],"order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"61a5208deadb750070998ed4","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"SEPA Direct Debit Transactions","slug":"sepa-direct-debit-transactions","order":6,"from_sync":false,"reference":false,"_id":"61a5208deadb750070998e8b","version":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2017-07-27T17:33:18.096Z","__v":0},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5208deadb750070998e87","61a5208deadb750070998e88","61a5208deadb750070998e89","61a5208deadb750070998e8a","61a5208deadb750070998e8b","61a5208deadb750070998e8c","61a5208deadb750070998e8d","61a5208deadb750070998e8e","61a5208deadb750070998e8f","61a5208deadb750070998e90","61a5208deadb750070998e91","61a5208deadb750070998e92","61a5208deadb750070998e93","61a5208deadb750070998e94","61a5208deadb750070998e95","61a5208deadb750070998e96","61a5208deadb750070998e97","61a5208deadb750070998e98","61a5208deadb750070998e99","61a5208deadb750070998e9a"],"_id":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60fed269718a45001c25b4a0","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2017-07-27T17:49:06.767Z","githubsync":"","__v":0}