{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/alt-transactions/resolve","auth":"optional","results":{"codes":[{"code":"","language":"text"}]},"settings":"57ee593a21ceb20e0061959e","examples":{"codes":[]},"method":"get","params":[{"name":"orderId","type":"int","default":"","desc":"Order ID received in the Create LBT Transaction response from BlueSnap","required":false,"in":"query","ref":"","_id":"596cf1cb20660f0015f5191a"}]},"next":{"description":"","pages":[]},"title":"Retrieve LBT Transaction","type":"endpoint","slug":"retrieve-lbt-transaction","excerpt":"","body":"[block:html]\n{\n \"html\": \"<script>\\n // hide body textbox of API Explorer\\n $(document).ready(function() {\\n $(\\\"textarea[placeholder='Body Content']\\\").hide(); \\n }); \\n</script>\"\n}\n[/block]\nThis request gets details about a past [Local Bank Transfer (LBT) transaction](/docs/local-bank-transfer), processed via the Payment API or the Hosted Payment Page. \n\n<br />\n\n<a class=\"btn btn-success\" href=\"#section-api-explorer-for-request-based-on-order-id-\" role=\"button\">Try it in the API Explorer</a>\n\n\n###Request Content\n\nNo content is required in the request body. Enter the relevant IDs in the request URL, as follows:\n\n**Retrieve based on Order ID**\nThe order ID can be used to retrieve the transaction at any point. BlueSnap returns the order ID in the [Create LBT Transaction](doc:create-lbt-transaction) response. \n\nEnter the `orderId` into the web service URL, in the format:\n`services/2/alt-transactions/resolve?orderId={order ID}`\n\nFor example: `services/2/alt-transactions/resolve?orderId=18727557`\n\n**Retrieve based on Transaction ID**\nIf the shopper has completed their purchase (`processingStatus` is `success`), the transaction will be assigned a transaction ID.\n\nEnter the `transactionId` into the web service URL, in the format:\n`services/2/alt-transactions/{transaction ID}`\n\nFor example: `services/2/alt-transactions/1034522153`\n\n**Note:** If the shopper has not completed their purchase (`processingStatus` is `pending`), the transaction will not have a transaction ID yet, so you will need to retrieve based on order ID. \n\n**Retrieve based on Merchant Transaction ID and Merchant ID**\nEnter the `merchantTransactionId` and `merchantId` into the web service URL, in the format:\n`services/2/alt-transactions/{merchantTransactionId},{merchantId}`\n\nFor example: `services/2/alt-transactions/unique_001,395608`\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `altTransaction` resource (see [altTransaction](doc:alt-transaction)). \n \n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/resolve?orderId=18727557 \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n \"language\": \"curl\",\n \"name\": \"Retrieve LBT Transaction by order ID\"\n },\n {\n \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/lbt-8202020,395608 \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n \"language\": \"curl\",\n \"name\": \"by Merchant Transaction ID and Merchant ID\"\n }\n ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"amount\\\": 70,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"country\\\": \\\"us\\\"\\n },\\n \\\"vaultedShopperId\\\": 28381653,\\n \\\"localBankTransferTransaction\\\": {\\n \\\"localBankTransferInfo\\\": {\\n \\\"swiftCode\\\": \\\"RABOUS66XXX\\\",\\n \\\"paymentReference\\\": \\\"410001044179\\\",\\n \\\"accountHolder\\\": \\\"Global Collect BV\\\",\\n \\\"bankCode\\\": \\\"ABA|122238420||Address|WESTLAKE VILLAGE, 2663 TOWNSGATE RD\\\",\\n \\\"bankName\\\": \\\"Rabobank N.A.\\\",\\n \\\"countryDescription\\\": \\\"United States\\\",\\n \\\"bankCity\\\": \\\"Ontario USA\\\",\\n \\\"bankAccountNumber\\\": \\\"0487369908\\\"\\n },\\n \\\"orderId\\\": 18727557\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"PENDING\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Order ID\"\n },\n {\n \"code\": \"{\\n \\\"merchantTransactionId\\\": \\\"lbt-8202020\\\",\\n \\\"softDescriptor\\\": \\\"ABCD COMPANY\\\",\\n \\\"amount\\\": 42,\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"payerInfo\\\": {\\n \\\"firstName\\\": \\\"John\\\",\\n \\\"lastName\\\": \\\"Doe\\\",\\n \\\"country\\\": \\\"us\\\"\\n },\\n \\\"vaultedShopperId\\\": 28382047,\\n \\\"localBankTransferTransaction\\\": {\\n \\\"localBankTransferInfo\\\": {\\n \\\"swiftCode\\\": \\\"RABOUS66XXX\\\",\\n \\\"paymentReference\\\": \\\"410001044199\\\",\\n \\\"accountHolder\\\": \\\"Global Collect BV\\\",\\n \\\"bankCode\\\": \\\"ABA|122238420||Address|WESTLAKE VILLAGE, 2663 TOWNSGATE RD\\\",\\n \\\"bankName\\\": \\\"Rabobank N.A.\\\",\\n \\\"countryDescription\\\": \\\"United States\\\",\\n \\\"bankCity\\\": \\\"Ontario USA\\\",\\n \\\"bankAccountNumber\\\": \\\"0487369908\\\"\\n },\\n \\\"orderId\\\": 18728045\\n },\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"PENDING\\\"\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Merchant Transaction ID and Merchant ID\"\n }\n ]\n}\n[/block]\n##API Explorer (for request based on Order ID)\nTo test out a call, enter an existing order ID (e.g. *18727557*) in the `orderId` field; this automatically inserts the ID into the request URL. Then, click **Try it!**.","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5fc6c6094cb8fa066b0d2e98","createdAt":"2020-03-24T21:29:24.127Z","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":"5fc6c6094cb8fa066b0d2e01","createdAt":"2020-03-24T21:25:24.892Z","version":"5fc6c6094cb8fa066b0d2ea3","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.36 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5fc6c6094cb8fa066b0d2df1","5fc6c6094cb8fa066b0d2df2","5fc6c6094cb8fa066b0d2df3","5fc6c6094cb8fa066b0d2df4","5fc6c6094cb8fa066b0d2df5","5fc6c6094cb8fa066b0d2df6","5fc6c6094cb8fa066b0d2df7","5fc6c6094cb8fa066b0d2df8","5fc6c6094cb8fa066b0d2df9","5fc6c6094cb8fa066b0d2dfa","5fc6c6094cb8fa066b0d2dfb","5fc6c6094cb8fa066b0d2dfc","5fc6c6094cb8fa066b0d2dfd","5fc6c6094cb8fa066b0d2dfe","5fc6c6094cb8fa066b0d2dff","5fc6c6094cb8fa066b0d2e00","5fc6c6094cb8fa066b0d2e01","5fc6c6094cb8fa066b0d2e02","5fc6c6226f585a06ba4b9746"],"_id":"5fc6c6094cb8fa066b0d2ea3","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5f43d7db37d54d01d8ef0876","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":23,"parentDoc":null}
getRetrieve LBT Transaction
Definition
Parameters
Query Params
Documentation
This request gets details about a past Local Bank Transfer (LBT) transaction, processed via the Payment API or the Hosted Payment Page.
Request Content
No content is required in the request body. Enter the relevant IDs in the request URL, as follows:
Retrieve based on Order ID
The order ID can be used to retrieve the transaction at any point. BlueSnap returns the order ID in the Create LBT Transaction response.
Enter the orderId
into the web service URL, in the format:services/2/alt-transactions/resolve?orderId={order ID}
For example: services/2/alt-transactions/resolve?orderId=18727557
Retrieve based on Transaction ID
If the shopper has completed their purchase (processingStatus
is success
), the transaction will be assigned a transaction ID.
Enter the transactionId
into the web service URL, in the format:services/2/alt-transactions/{transaction ID}
For example: services/2/alt-transactions/1034522153
Note: If the shopper has not completed their purchase (processingStatus
is pending
), the transaction will not have a transaction ID yet, so you will need to retrieve based on order ID.
Retrieve based on Merchant Transaction ID and Merchant ID
Enter the merchantTransactionId
and merchantId
into the web service URL, in the format:services/2/alt-transactions/{merchantTransactionId},{merchantId}
For example: services/2/alt-transactions/unique_001,395608
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the retrieved altTransaction
resource (see altTransaction).
Examples
Request Examples
curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/resolve?orderId=18727557 \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/lbt-8202020,395608 \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 70,
"currency": "USD",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"country": "us"
},
"vaultedShopperId": 28381653,
"localBankTransferTransaction": {
"localBankTransferInfo": {
"swiftCode": "RABOUS66XXX",
"paymentReference": "410001044179",
"accountHolder": "Global Collect BV",
"bankCode": "ABA|122238420||Address|WESTLAKE VILLAGE, 2663 TOWNSGATE RD",
"bankName": "Rabobank N.A.",
"countryDescription": "United States",
"bankCity": "Ontario USA",
"bankAccountNumber": "0487369908"
},
"orderId": 18727557
},
"processingInfo": {
"processingStatus": "PENDING"
}
}
{
"merchantTransactionId": "lbt-8202020",
"softDescriptor": "ABCD COMPANY",
"amount": 42,
"currency": "USD",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"country": "us"
},
"vaultedShopperId": 28382047,
"localBankTransferTransaction": {
"localBankTransferInfo": {
"swiftCode": "RABOUS66XXX",
"paymentReference": "410001044199",
"accountHolder": "Global Collect BV",
"bankCode": "ABA|122238420||Address|WESTLAKE VILLAGE, 2663 TOWNSGATE RD",
"bankName": "Rabobank N.A.",
"countryDescription": "United States",
"bankCity": "Ontario USA",
"bankAccountNumber": "0487369908"
},
"orderId": 18728045
},
"processingInfo": {
"processingStatus": "PENDING"
}
}