This request gets details about a past SEPA Direct Debit 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.

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

For example: services/2/alt-transactions/1105235763

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).

Staying informed of the transaction status

The processingStatus property is returned in the response, and it indicates the status of the transaction. The possible values are as follows.

Property values	Invoice status
`FAIL`	Canceled and the shopper's account was not debited
`PENDING`	Not yet approved
`REFUNDED`	Refunded in response to a chargeback or refund requested by the shopper
`SUCCESS`	Approved and the shopper's account was debited

Examples

Request Examples

curl -v -X GET https://sandbox.bluesnap.com/services/2/alt-transactions/38504790 \
-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/unique_001,395608 \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '

Response Examples

The below examples assume the shopper's bank has approved the transaction and their account has been debited, shown by a processingStatus value of SUCCESS.

{
    "transactionId": "1105235763",
    "softDescriptor": "Testing",
    "amount": 9.65,
    "currency": "EUR",
    "transactionApprovalDate": "09/29/2020",
    "transactionApprovalTime": "13:08:47",
    "payerInfo": {
        "firstName": "John",
        "lastName": "Doe"
    },
    "vaultedShopperId": 21788723,
    "sepaDirectDebitTransaction": {
        "ibanFirstFour": "DE09",
        "ibanLastFour": "7893",
        "mandateId": "Ooo153467",
        "mandateDate": "30-Sep-20"
    },
    "processingInfo": {
        "processingStatus": "SUCCESS",
        "transactionRegion": "UK"
    }
}

{
    "merchantTransactionId": "unique_001",
    "transactionId": "1105235763",
    "softDescriptor": "Testing",
    "amount": 9.65,
    "currency": "EUR",
    "transactionApprovalDate": "09/29/2020",
    "transactionApprovalTime": "13:08:47",
    "payerInfo": {
        "firstName": "John",
        "lastName": "Doe"
    },
    "vaultedShopperId": 21788723,
    "sepaDirectDebitTransaction": {
        "ibanFirstFour": "DE09",
        "ibanLastFour": "7893",
        "mandateId": "Ooo153467",
        "mandateDate": "30-Sep-20"
    },
    "processingInfo": {
        "processingStatus": "SUCCESS"
    }
}

API Explorer

Transaction ID Requests

To test out a call, enter an existing transaction ID (e.g. 1014672453) in the transactionId field; this automatically inserts the ID into the request URL. Then, click Try it!.