{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/alt-transactions","auth":"optional","results":{"codes":[{"code":"","language":"text"}]},"settings":"","examples":{"codes":[]},"method":"post","params":[]},"next":{"description":"","pages":[]},"title":"Create LBT Transaction","type":"endpoint","slug":"create-lbt-transaction","excerpt":"","body":"The Create Local Bank Transfer (LBT) Transaction request obtains account details for a transaction. The shopper **must**  complete the transaction.  Their account is not immediately debited.  For more information on Local Bank Transfer, refer to the [Local Bank Transfer](https://support.bluesnap.com/docs/local-bank-transfer) guide. If you would like to offer Local Bank Transfer, contact [Merchant Support](https://bluesnap.zendesk.com/hc/en-us/requests/new?ticket_form_id=360000127087) to have it enabled for your account. \n\n<br>\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Short payments\",\n  \"body\": \"If the amount received from the shopper is less than the order total, this is considered a [short payment](https://support.bluesnap.com/docs/local-bank-transfer#short-payments). If a short payment requires your approval, send a [Merchant Approve Transaction](/v8976-XML/docs/merchant-approval) request with the transaction ID.\"\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&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;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`vendors-info` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required** if using marketplace vendor(s)</span> (refer to [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> (refer to [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;`local-bank-transfer-transaction` &nbsp;&nbsp;&nbsp; *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span> (refer to [local-bank-transfer-transaction](doc:local-bank-transfer-transaction))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`transaction-meta-data` &nbsp;&nbsp;&nbsp; *container* &nbsp;&nbsp;&nbsp;optional (refer to [transaction-meta-data](doc:transaction-meta-data))\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;`vaulted-shopper-id`\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`local-bank-transfer-transaction` &nbsp;&nbsp;&nbsp;(refer to [local-bank-transfer-transaction](doc:local-bank-transfer-transaction))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`processing-info`&nbsp;&nbsp;&nbsp;(refer to [processing-info](doc:processing-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    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <country>us</country>\\n    </payer-info>\\n    <local-bank-transfer-transaction />\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"Basic request\"\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    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <country>us</country>\\n    </payer-info>\\n    <local-bank-transfer-transaction />\\n    <soft-descriptor>ABC COMPANY</soft-descriptor>\\n    <transaction-meta-data>\\n        <meta-data>\\n            <meta-key>stateTaxAmount</meta-key>\\n            <meta-value>20.00</meta-value>\\n            <meta-description>State Tax Amount</meta-description>\\n        </meta-data>\\n        <meta-data>\\n            <meta-key>cityTaxAmount</meta-key>\\n            <meta-value>20.00</meta-value>\\n            <meta-description>City Tax Amount</meta-description>\\n        </meta-data>\\n    </transaction-meta-data>\\n    <merchant-transaction-id>abc123</merchant-transaction-id>\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"with softDescriptor, MTI and metadata\"\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    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <country>us</country>\\n    </payer-info>\\n    <local-bank-transfer-transaction />\\n    <vendors-info>\\n        <vendor-info>\\n            <vendor-id>10398032</vendor-id>\\n        </vendor-info>\\n    </vendors-info>\\n</alt-transaction>'\",\n      \"language\": \"curl\",\n      \"name\": \"with vendors info\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <country>us</country>\\n    </payer-info>\\n    <vaulted-shopper-id>19584260</vaulted-shopper-id>\\n    <local-bank-transfer-transaction>\\n        <local-bank-transfer-info>\\n            <swift-code>RABOUS66XXX</swift-code>\\n            <payment-reference>410000825969</payment-reference>\\n            <account-holder>Global Collect BV</account-holder>\\n            <bank-code>ABA|122238420||Address|WESTLAKE VILLAGE, 2663 TOWNSGATE RD</bank-code>\\n            <bank-name>Rabobank N.A.</bank-name>\\n            <country-description>United States</country-description>\\n            <bank-city>Ontario USA</bank-city>\\n            <bank-account-number>0487369908</bank-account-number>\\n        </local-bank-transfer-info>\\n        <order-id>4002617</order-id>\\n    </local-bank-transfer-transaction>\\n    <processing-info>\\n        <processing-status>PENDING</processing-status>\\n    </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"Basic response\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction\\n    xmlns=\\\"http://ws.plimus.com\\\">\\n    <merchant-transaction-id>abc123</merchant-transaction-id>\\n    <soft-descriptor>ABC COMPANY</soft-descriptor>\\n    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <country>us</country>\\n    </payer-info>\\n    <vaulted-shopper-id>19584262</vaulted-shopper-id>\\n    <transaction-meta-data>\\n        <meta-data>\\n            <meta-key>cityTaxAmount</meta-key>\\n            <meta-value>20.00</meta-value>\\n            <meta-description>City Tax Amount</meta-description>\\n        </meta-data>\\n        <meta-data>\\n            <meta-key>stateTaxAmount</meta-key>\\n            <meta-value>20.00</meta-value>\\n            <meta-description>State Tax Amount</meta-description>\\n        </meta-data>\\n    </transaction-meta-data>\\n    <local-bank-transfer-transaction>\\n        <local-bank-transfer-info>\\n            <swift-code>RABOUS66XXX</swift-code>\\n            <payment-reference>410000825979</payment-reference>\\n            <account-holder>Global Collect BV</account-holder>\\n            <bank-code>ABA|122238420||Address|WESTLAKE VILLAGE, 2663 TOWNSGATE RD</bank-code>\\n            <bank-name>Rabobank N.A.</bank-name>\\n            <country-description>United States</country-description>\\n            <bank-city>Ontario USA</bank-city>\\n            <bank-account-number>0487369908</bank-account-number>\\n        </local-bank-transfer-info>\\n        <order-id>4002619</order-id>\\n    </local-bank-transfer-transaction>\\n    <processing-info>\\n        <processing-status>PENDING</processing-status>\\n    </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"Response with softDescriptor, MTI and metadata\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<alt-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n    <vendors-info>\\n        <vendor-info>\\n            <vendor-id>10398032</vendor-id>\\n            <commission-percent>90.2</commission-percent>\\n        </vendor-info>\\n    </vendors-info>\\n    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <country>us</country>\\n    </payer-info>\\n    <vaulted-shopper-id>27670687</vaulted-shopper-id>\\n    <local-bank-transfer-transaction>\\n        <local-bank-transfer-info>\\n            <swift-code>RABOUS66XXX</swift-code>\\n            <payment-reference>410000932249</payment-reference>\\n            <account-holder>Global Collect BV</account-holder>\\n            <bank-code>ABA&#x7c;122238420&#x7c;&#x7c;Address&#x7c;WESTLAKE VILLAGE, 2663 TOWNSGATE RD</bank-code>\\n            <bank-name>Rabobank N.A.</bank-name>\\n            <country-description>United States</country-description>\\n            <bank-city>Ontario USA</bank-city>\\n            <bank-account-number>0487369908</bank-account-number>\\n        </local-bank-transfer-info>\\n        <order-id>17649643</order-id>\\n    </local-bank-transfer-transaction>\\n    <processing-info>\\n        <processing-status>PENDING</processing-status>\\n    </processing-info>\\n</alt-transaction>\",\n      \"language\": \"xml\",\n      \"name\": \"with vendors info\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Order ID and status\",\n  \"body\": \"Until the shopper completes the order, the processing status stays as `PENDING` and there is no transaction ID.  You must use the `order-id` for the transaction.\"\n}\n[/block]\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 refer to 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    <amount>70</amount>\\n    <currency>USD</currency>\\n    <payer-info>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n                <country>us</country>\\n    </payer-info>\\n    <local-bank-transfer-transaction/>\\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":"5ed5174637c3c607440c0a37","createdAt":"2020-03-24T18:16:22.493Z","user":"5beb1b96bc2003003ecd645e","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Local Bank Transfer transactions","slug":"local-bank-transfer-transactions","order":5,"from_sync":false,"reference":false,"_id":"5ed5174637c3c607440c099c","createdAt":"2020-03-24T18:10:08.271Z","version":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed5174637c3c607440c098b","5ed5174637c3c607440c098c","5ed5174637c3c607440c098d","5ed5174637c3c607440c098e","5ed5174637c3c607440c098f","5ed5174637c3c607440c0990","5ed5174637c3c607440c0991","5ed5174637c3c607440c0992","5ed5174637c3c607440c0993","5ed5174637c3c607440c0994","5ed5174637c3c607440c0995","5ed5174637c3c607440c0996","5ed5174637c3c607440c0997","5ed5174637c3c607440c0998","5ed5174637c3c607440c0999","5ed5174637c3c607440c099a","5ed5174637c3c607440c099b","5ed5174637c3c607440c099c"],"_id":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3a02fb6fb40050cb3c15","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}