Skip to content

Status query

A status query operation is a quick look up on API transaction results.

Request

To get information about a transaction status or transaction details, send a GET request to https://processing.ecomcharge.com/transactions/{uid}, where {uid} stands for the UID value assigned by the eComCharge system to the transaction that you want to get information for. uid is received in an authorization or payment response.

To receive transactions information by tracking_id send a GET request to https://processing.ecomcharge.com/v2/transactions/tracking_id/{tracking_id}, where {tracking_id} stands for the ID value assigned by you to the transaction or the order that you want to get information for. tracking_id is submitted in an authorization or payment request.

Info

If the tracking ID is not unique per transaction, the system returns an array of up to 10 recent transactions with a matching tracking ID.

Response
Example of the response 
{
  "transaction": {
    "uid": "3fffb637-aa8e-4f7d-9180-c19688d2dce1",
    "status": "successful",
    "amount": 492,
    "currency": "EUR",
    "description": "Test transaction",
    "type": "payment",
    "payment_method_type": "credit_card",
    "tracking_id": "your_uniq_number",
    "message": "Successfully processed",
    "test": true,
    "created_at": "2024-04-02T14:19:04.692Z",
    "updated_at": "2024-04-02T14:19:12.733Z",
    "paid_at": "2024-04-02T14:19:12.677Z",
    "expired_at": null,
    "recurring_type": "initial",
    "closed_at": null,
    "settled_at": null,
    "manually_corrected_at": null,
    "language": "en",
    "credit_card": {
      "holder": "John Doe",
      "stamp": "bb58cad9c1204ca2287b3e1006cc1a2c0fb8f062dde9e5232c8be5498bd0e62a",
      "brand": "visa",
      "last_4": "1097",
      "first_1": "4",
      "bin": "401200",
      "bin_8": "40120000",
      "issuer_country": null,
      "issuer_name": null,
      "product": null,
      "exp_month": 7,
      "exp_year": 2026,
      "token_provider": null,
      "token": "f969f92f-82fa-45b2-9974-38cecdf9648e"
    },
    "receipt_url": "https://gateway.ecomcharge.com/customer/transactions/3fffb637-aa8e-4f7d-9180-c19688d2dce1/a091d2bd58c1a96bc15b7cf2d9b5a8e99e1f9615bac75eae5515e123e1b1bd5c?language=en",
    "status_code": null,
    "gateway": {
      "iframe": true
    },
    "mute_notifications": null,
    "id": "3fffb637-aa8e-4f7d-9180-c19688d2dce1",
    "additional_data": {
      "contract": [
        "recurring"
      ]
    },
    "redirect_url": "https://processing.ecomcharge.com/process/3fffb637-aa8e-4f7d-9180-c19688d2dce1",
    "code": "S.0000",
    "friendly_message": "The operation is successful.",
    "smart_routing_verification": {
      "status": "successful"
    },
    "payment": {
      "auth_code": "654321",
      "bank_code": "05",
      "rrn": "999",
      "ref_id": "777888",
      "message": "Payment was approved",
      "amount": 492,
      "currency": "EUR",
      "billing_descriptor": "test descriptor",
      "gateway_id": 3483,
      "status": "successful"
    },
    "customer": {
      "ip": null,
      "email": null,
      "device_id": null,
      "birth_date": null
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "address": "1st Street",
      "country": "US",
      "city": "Denver",
      "zip": "96002",
      "state": "CO",
      "phone": null
    }
  }
}