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://demo-gateway.begateway.com/transactions/{uid}, where {uid} stands for the UID value assigned by the Demo PSP 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://demo-gateway.begateway.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
{
   "transactions": [
   {
         "uid": "21893-caaf7c37ad",
         "status": "failed",
         "amount": 100,
         "currency": "USD",
         "description": "Test transaction",
         "type": "payment",
         "payment_method_type": "credit_card",
         "tracking_id": "tracking_id_000",
         "message": "Internal decline",
         "test": true,
         "created_at": "2022-03-17T14:15:25.995Z",
         "updated_at": "2022-03-17T16:00:48.570Z",
         "paid_at": null,
         "expired_at": "2025-01-01T14:00:00.000Z",
         "recurring_type": null,
         "closed_at": null,
         "settled_at": null,
         "manually_corrected_at": null,
         "language": "en",
         "credit_card": {
            "holder": "John Doe",
            "stamp": "b3839d334ba40e89168d60cd9f9d1390aee3fe67dd4d5c41adbf3998043eaef8",
            "brand": "visa",
            "last_4": "0000",
            "first_1": "4",
            "bin": "420000",
            "issuer_country": "US",
            "issuer_name": "VISA Demo Bank",
            "product": "F",
            "exp_month": 10,
            "exp_year": 2026,
            "token_provider": null,
            "token": null
         },
         "receipt_url": "https://demo-backoffice.begateway.com/customer/transactions/21893-caaf7c37ad/7424546697be9d05cb1574627fe2054e9719245249e46ada1a5b82197ca97a2e?language=en",
         "status_code": null,
         "id": "21893-caaf7c37ad",
         "additional_data": {
            "browser": {
               "screen_width": 1920,
               "screen_height": 1080,
               "screen_color_depth": 24,
               "language": "en",
               "java_enabled": false,
               "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
               "time_zone": -180,
               "time_zone_name": "Europe/Milan",
               "accept_header": "*/*",
               "window_height": 667,
               "window_width": 600
            }
         },
         "redirect_url": "https://demo-gateway.begateway.com/process/21893-caaf7c37ad",
         "transaction_verification": {
            "message": null,
            "status": "incomplete"
         },
         "be_protected_verification": {
            "status": "incomplete",
            "message": null
         },
         "payment": {
            "auth_code": null,
            "bank_code": null,
            "rrn": null,
            "ref_id": null,
            "message": "Internal decline",
            "amount": 100,
            "currency": "USD",
            "billing_descriptor": null,
            "gateway_id": 645,
            "status": "failed"
         },
         "avs_cvc_verification": {
            "avs_verification": {
               "result_code": null
            },
            "cvc_verification": {
               "result_code": null
            }
         },
         "customer": {
            "ip": "127.0.0.1",
            "email": "john@example.com",
            "device_id": "12312312321fff67",
            "birth_date": "1980-01-31"
         },
         "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "address": "1st Street",
            "country": "US",
            "city": "Denver",
            "zip": "96002",
            "state": "CO",
            "phone": null
         }
   },
   {
         "uid": "20885-ada59370aa",
         "status": "incomplete",
         "amount": 100,
         "currency": "USD",
         "description": "Test transaction",
         "type": "payment",
         "payment_method_type": "credit_card",
         "tracking_id": "tracking_id_000",
         "message": null,
         "test": true,
         "created_at": "2022-02-08T13:35:45.835Z",
         "updated_at": "2022-02-08T13:35:47.926Z",
         "paid_at": null,
         "expired_at": null,
         "recurring_type": null,
         "closed_at": null,
         "settled_at": null,
         "manually_corrected_at": null,
         "language": "en",
         "credit_card": {
            "holder": "John Doe",
            "stamp": "3f6d17331f4e0d6e20cd77deb3d053ece49413fc35f4ad0633c3f0079bcf0e78",
            "brand": "mir",
            "last_4": "0047",
            "first_1": "2",
            "bin": "220138",
            "issuer_country": "RU",
            "issuer_name": null,
            "product": null,
            "exp_month": 10,
            "exp_year": 2026,
            "token_provider": null,
            "token": null
         },
         "receipt_url": "https://demo-backoffice.begateway.com/customer/transactions/20885-ada59370aa/7b29f4f59eecba1e0c6917fb8686bb03fc6ce42235f95f851f51c5d2d60a868e?language=en",
         "status_code": null,
         "id": "20885-ada59370aa",
         "additional_data": {
            "browser": {
               "screen_width": 1920,
               "screen_height": 1080,
               "screen_color_depth": 24,
               "language": "en",
               "java_enabled": false,
               "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
               "time_zone": -180,
               "time_zone_name": "Europe/Milan",
               "accept_header": "*/*",
               "window_height": 667,
               "window_width": 600
            }
         },
         "redirect_url": "https://demo-gateway.begateway.com/process/20885-ada59370aa",
         "be_protected_verification": {
            "status": "successful",
            "message": null,
            "white_black_list": {
               "email": "absent",
               "ip": "absent",
               "card_number": "absent"
            },
            "rules": {
               "1_60_Demo Shop": {},
               "1_Demo 123": {},
               "Demo PSP": {}
            }
         },
         "three_d_secure_verification": {
            "status": "incomplete",
            "message": "Authentication Available",
            "ve_status": "Y",
            "acs_url": null,
            "pa_req": null,
            "md": null,
            "pa_res_url": "https://demo-gateway.begateway.com/process/20885-ada59370aa",
            "eci": null,
            "pa_status": null,
            "xid": null,
            "cavv": null,
            "cavv_algorithm": null,
            "fail_reason": null,
            "method_process_url": null,
            "creq": null
         },
         "payment": {
            "auth_code": null,
            "bank_code": null,
            "rrn": null,
            "ref_id": null,
            "message": null,
            "amount": 100,
            "currency": "USD",
            "billing_descriptor": null,
            "gateway_id": 645,
            "status": "incomplete"
         },
         "avs_cvc_verification": {
            "avs_verification": {
               "result_code": null
            },
            "cvc_verification": {
               "result_code": null
            }
         },
         "customer": {
            "ip": "127.0.0.1",
            "email": "john@example.com",
            "device_id": "12312312321fff67",
            "birth_date": "1980-01-31"
         },
         "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "address": "1st Street",
            "country": "US",
            "city": "Denver",
            "zip": "96002",
            "state": "CO",
            "phone": null
         }
   }
]
}