Retrieve ECP Transaction · Developer Hub

This request gets details about a past ECP transaction, such as the transaction ID, amount, currency, payer info or vaulted shopper, and so on.

Note: If you are using the API + Hosted Page Hybrid solution, this can also return transactions created in Hosted Payment Pages.

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 Transaction ID
Enter the transaction-id into the web service URL, in the format:
services/2/alt-transactions/{transaction-id}

For example:
services/2/transactions/38504790

Retrieve based on Merchant Transaction ID and Merchant ID
Enter the merchant-id and merchant-transaction-id into the web service URL, in the format:
services/2/alt-transactions/{merchant-transaction-id},{merchant-id}

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 alt-transaction resource (see alt-transaction).

Examples

Request Examples

Retrieve ECP Transaction Request: by Transaction ID

by Merchant Transaction ID and Merchant ID

curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/38504790 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/unique_001,395608 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Response Examples

Retrieve ECP Transaction Response: 200 OK - by Transaction ID

- by Merchant Transaction ID and Merchant ID

- with vendor ID

200 OK API v3.0 - by Transaction ID

<?xml version="1.0" encoding="UTF-8"?>
<alt-transaction xmlns="http://ws.plimus.com">
   <transaction-id>38504790</transaction-id>
   <soft-descriptor>ABC COMPANY</soft-descriptor>
   <amount>100</amount>
   <currency>USD</currency>
   <payer-info>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <zip>12345</zip>
      <phone>1234567890</phone>
   </payer-info>
   <ecp-transaction>
      <account-number>4099999992</account-number>
      <routing-number>011075150</routing-number>
      <account-type>CONSUMER_CHECKING</account-type>
   </ecp-transaction>
   <processing-info>
      <processing-status>SUCCESS</processing-status>
   </processing-info>
</alt-transaction>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
    <merchant-transaction-id>unique_001</merchant-transaction-id>
    <transaction-id>38504788</transaction-id>
    <amount>100</amount>
    <currency>USD</currency>
    <payer-info>
        <first-name>John</first-name>
        <last-name>Doe</last-name>
        <zip>12345</zip>
        <phone>1234567890</phone>
    </payer-info>
    <ecp-transaction>
        <account-number>4099999992</account-number>
        <routing-number>011075150</routing-number>
        <account-type>CONSUMER_CHECKING</account-type>
    </ecp-transaction>
    <processing-info>
        <processing-status>SUCCESS</processing-status>
    </processing-info>
</alt-transaction>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
    <merchant-transaction-id>456</merchant-transaction-id>
    <transaction-id>38418384</transaction-id>
    <vendor-info>
        <vendor-id>397808</vendor-id>
        <commission-percent>20</commission-percent>
    </vendor-info>
    <soft-descriptor>ABC COMPANY</soft-descriptor>
    <amount>50</amount>
    <currency>USD</currency>
    <payer-info>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <zip>12345</zip>
      <phone>1234567890</phone>
    </payer-info>
    <ecp-transaction>
      <account-number>4099999992</account-number>
      <routing-number>011075150</routing-number>
      <account-type>CONSUMER_CHECKING</account-type>
    </ecp-transaction>
    <processing-info>
        <processing-status>REFUNDED</processing-status>
    </processing-info>
    <refunds>
        <balance-amount>49.00</balance-amount>
        <vendor-balance-amount>9.80</vendor-balance-amount>
        <refund>
            <amount>1.00</amount>
            <vendor-amount>0.20</vendor-amount>
            <currency>USD</currency>
            <date>2016-09-29</date>
        </refund>
    </refunds>
</alt-transaction>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alt-transaction xmlns="http://ws.plimus.com">
    <transaction-id>38505332</transaction-id>
    <soft-descriptor>ABC COMPANY</soft-descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <payer-info>
        <first-name>John</first-name>
        <last-name>Doe</last-name>
        <zip>12345</zip>
        <phone>1234567890</phone>
    </payer-info>
    <vaulted-shopper-id>19570144</vaulted-shopper-id>
    <ecp-transaction>
        <account-type>CONSUMER_CHECKING</account-type>
        <public-account-number>99992</public-account-number>
        <public-routing-number>75150</public-routing-number>
    </ecp-transaction>
    <processing-info>
        <processing-status>PENDING</processing-status>
    </processing-info>
</alt-transaction>

Note:

In API v3.0, the <ecp-transaction> in the Response returns the private data.

API Explorer (for request based on Transaction ID)

To test out a call, enter an existing transaction ID in the transaction-id field. This automatically inserts the ID into the request URL. Leave the Body Content field empty.

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

Developer Hub

Payment API (XML)

Card/Wallet 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

getRetrieve ECP Transaction

Definition

Parameters

Path Params

Documentation