{"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":"5f43d7db37d54d01d8ef0871","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":6,"from_sync":false,"reference":false,"_id":"5f43d7db37d54d01d8ef07db","createdAt":"2020-03-24T21:25:24.892Z","version":"5f43d7db37d54d01d8ef0876","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.35 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5f43d7db37d54d01d8ef07cb","5f43d7db37d54d01d8ef07cc","5f43d7db37d54d01d8ef07cd","5f43d7db37d54d01d8ef07ce","5f43d7db37d54d01d8ef07cf","5f43d7db37d54d01d8ef07d0","5f43d7db37d54d01d8ef07d1","5f43d7db37d54d01d8ef07d2","5f43d7db37d54d01d8ef07d3","5f43d7db37d54d01d8ef07d4","5f43d7db37d54d01d8ef07d5","5f43d7db37d54d01d8ef07d6","5f43d7db37d54d01d8ef07d7","5f43d7db37d54d01d8ef07d8","5f43d7db37d54d01d8ef07d9","5f43d7db37d54d01d8ef07da","5f43d7db37d54d01d8ef07db","5f45521ec5bfe9005a858533"],"_id":"5f43d7db37d54d01d8ef0876","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5ed0377101fdb400214dedaa","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":23,"parentDoc":null}

getRetrieve LBT Transaction


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

orderId:
integer
Order ID received in the Create LBT Transaction response from BlueSnap

Documentation

This request gets details about a past Local Bank Transfer (LBT) transaction, processed via the Payment API or the Hosted Payment Page.


Try it in the API Explorer

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 '

Response Examples

{
  "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"
  }
}

API Explorer (for request based on Order ID)

To 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!.


User Information

Try It Out


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