Agent API {find-transaction}
This API method will return the transaction in the same format as the notification that was sent with the last transaction status change.
Endpoints
| Name | URL |
|---|---|
| Sandbox | https://pci-gw-test.praxispay.com/agent/find-transaction |
| Live | https://gw.praxisgate.com/agent/find-transaction |
Request Parameters
✓ - required value
? - optional, value or null
✕ - always appears as null
| Variable | Type | Description | |
|---|---|---|---|
| merchant_id | varchar(50) | ✓ | Merchant API client account identifier |
| application_key | varchar(32) | ✓ | Identifier of your application (website) |
| tid | int(11) | ✓ | transaction identifier |
| version | varchar(3) | ✓ | API version |
| timestamp | int(11) | ✓ | Request time (unix timestamp, seconds) |
Response Parameters
| Variable | Type | Description | |
|---|---|---|---|
| status | int | ✓ | API communication status - for transaction processing status please refer to transaction.transaction.status - 0 if the request was successful - Negative integer if internal server/network error occurs - Positive integer if application/logical error occurs |
| description | varchar(256) | ✓ | Accurate description of the result. Return the actual error for any exception as it helps to diagnose issues in production |
| customer | <Object> | ? | Customer object. Appears as null for authentication/validation errors and expired session. |
| session | <Object> | ? | Session object. Appears as null for authentication/validation errors and expired session. |
| transaction | <Object> | ? | Transaction object. Appears as null for authentication/validation errors and expired session. |
| version | varchar(3) | ✓ | API version |
| timestamp | int(11) | ✓ | Response time (unix timestamp, seconds) |
Signature
The full signature generation algorithm can be found in the Authentication section.
Request signature parameters
merchant_idapplication_keytimestamptid
Response signature parameters
statustimestampcustomer.customer_tokentransaction.tidtransaction.transaction_statustransaction.processed_currencytransaction.processed_amount
Example
Request
{
"merchant_id": "Test-Integration-Merchant",
"application_key": "Sandbox",
"tid": 756850,
"version": "1.3",
"timestamp": 1590613956
}Response (Found)
{
"status": 0,
"description": "Ok",
"customer": {
"customer_token": "87cfb23a8f1e68e162c276b754d9c061",
"country": "GB",
"first_name": "John",
"last_name": "Johnson",
"avs_alert": 0,
"verification_alert": null
},
"session": {
"auth_token": "8a7sd87a8sd778ac961062c6bedddb8",
"intent": "payment",
"session_status": "created",
"order_id": "test-1560610955",
"currency": "EUR",
"amount": 100,
"conversion_rate": 1.000000,
"processed_currency": "EUR",
"processed_amount": 100,
"payment_method": "Credit Card",
"gateway": null,
"cid": "1",
"variable1": "your variable",
"variable2": "if that is not enough, you can pass even one more variable",
"variable3": null
},
"transaction": {
"transaction_type": "sale",
"transaction_status": "approved",
"tid": 756850,
"transaction_id": "13397",
"currency": "EUR",
"amount": 100,
"conversion_rate": 1.000000,
"charge_currency": "EUR",
"charge_amount": 100,
"fee": 0,
"payment_method": "Credit Card",
"payment_processor": "TestCardProcessor",
"gateway": "s-pTSZyK23E1Ee5KZpcNbX_aFl0HuhQ0",
"card": {
"card_token": "J-4-a0vPhjZ9R75JP98VDUFgbh9y8sYr",
"card_type": "VISA",
"card_number": "411111******1111",
"card_exp": "12\/2024",
"card_issuer_name": "Bank of Somewhere",
"card_issuer_country": "GB"
},
"wallet": null,
"is_3d": 0,
"is_cascade": 0,
"cascade_level": 0,
"reference_id": 756850,
"withdrawal_request_id": 756853,
"account_identifier": null,
"created_by": "INTERNET",
"edited_by": "INTERNET",
"status_code": "SC-002",
"status_details": "Transaction approved"
},
"version": "1.3",
"timestamp": 1590611635
}