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/api/find-transaction |
| Live | https://gw.praxisgate.com/api/find-transaction |
REQUEST PARAMETERS
| Variable | Type | Description |
|---|---|---|
| trace_id | int(11) | Required. Transaction identifier in |
| application_key | varchar(32) | Required. Identifier of your application (website) |
| merchant_id | varchar(50) | Required. Merchant API client account identifier |
| version | varchar(16) | Required. API version |
| timestamp | int(11) | Required. Request time. URL will be active during 1 min after this time |
| signature | varchar(96) | Required. Request signature. Please refer to How to Build Signature for details on signing the request. |
RESPONSE PARAMETERS
| Variable | Type | Description |
|---|---|---|
| status | int | Required. - 0 if the request was successful - Negative integer if internal server/network error occurs - Positive integer if application/logical error occurs |
| description | varchar(75) | Required. Accurate description of the result. Return the actual error for any exception as it helps to diagnose issues in production |
| transaction_type | varchar(16) | Required. Transaction type. Allowed values are: sale (deposit) payout (withdrawal) refund (return deposit funds) authorize (authorization and capture) |
| transaction_status | varchar(16) | Required. - pending - processing initiated, final response expected from PSP - approved - processing was successful - declined - processing failed - cancelled - processing cancelled by the merchant or client - requested - merchant action expected (approval) |
| transaction_id | varchar(50) | Optional. PSP transaction identifier |
| trace_id | int(11) | Required. transaction identifier |
| order_id | varchar(50) | sale - Optional. Transaction identifier in your system payout - Required. Transaction identifier in your system |
| application_key | varchar(32) | Required. Identifier of your application (website) |
| pin | varchar(50) | Required. Unique customer id in your system |
| amount | int(20) | Required. Transaction amount in cents Please note: for certain currencies (see full list here) there is a fraction other than 100 cents per unit, this is important if you multiply by 100 to send the amount in cents |
| currency | varchar(3) | Required. Transaction currency |
| charge_amount | int(20) | Required. Amount (in actual processing currency) in cents. Please note: for certain currencies (see full list here) there is a fraction other than 100 cents per unit, this is important if you multiply by 100 to send the amount in cents |
| charge_currency | varchar(3) | Required. Actual currency processed |
| payment_method | varchar(50) | Required. Payment method |
| payment_processor | varchar(50) | Required. Payment processor |
| gateway | varchar(32) | Optional. Gateway doing the processing |
| created_by | varchar(50) | Optional. Transaction was created by |
| edited_by | varchar(50) | Optional. Transaction was edited by |
| auth_token | varchar(32) | Optional. Auth token provided upon Cashier session init call |
| merchant_id | varchar(50) | Required. Merchant API client account identifier |
| card_number | varchar(19) | Optional. Customer card number (4444 44** **** 1233) |
| card_type | varchar(10) | Optional. Customer card type (AMEX, DinersClub, Discover, Electron, JCB, Maestro, MasterCard, Mir, VISA) |
| card_exp | varchar(8) | Optional. Customer card exp (10/2023) |
| account_identifier | varchar(256) | Optional. Customer account ID or login at PSP |
| cascade_level | int(2) | Optional. Transaction retry number |
| is_cascade | int(1) | Optional. Is this transaction goes through cascade |
| error_code | varchar(32) | Optional. Error code for rejected transactions |
| error_details | varchar(256) | Optional. Error description for rejected transactions |
| reference_id | int(11) | Optional. ID of transaction to reverse |
| version | varchar(16) | Required. API version |
| timestamp | int(11) | Required. Request time. URL will be active during 1 min after this time |
| variable1 | varchar(256) | Optional. Your custom field which will consist some neсessary information |
| variable2 | varchar(256) | Optional. Your custom field which will consist some neсessary information |
| signature | varchar(96) | Required. Request signature. Please refer to How to Build Signature for details on signing the request. |
EXAMPLE
For example below: Merchant Secret = "MerchantSecretKey"
Request
curl -X POST \
https://gateway.praxispay.com/api/find-transaction \
-H 'Content-Type: application/json' \
-d '{
"application_key": "Sandbox",
"merchant_id": "Test-Integration-Merchant",
"timestamp": 1578880026,
"trace_id": 1000000321,
"version": "1.2",
"signature": "693a9c2eb641ee126cb88d48ff57190ab614d6303d76177e0fe90348589c165f868a1dd01ecb0ad22450797eb29e720f"
}'
Response (OK)
{
"account_identifier": null,
"amount": 2500,
"application_key": "Sandbox",
"auth_token": "a60927468a5b32afe31468d780c57a32",
"card_exp": "12\/2024",
"card_number": "411111******1111",
"card_type": "VISA",
"cascade_level": null,
"created_by": "INTERNET",
"currency": "EUR",
"description": "Transaction found",
"edited_by": "INTERNET",
"error_code": null,
"error_details": null,
"gateway": "s-pTSZyK23E1Ee5KZpcNbX_aFl0HuhQ0",
"merchant_id": "Test-Integration-Merchant",
"order_id": null,
"payment_method": null,
"payment_processor": "TestPP",
"pin": "7",
"reference_id": null,
"status": 0,
"timestamp": 1578878718,
"trace_id": 756850,
"transaction_id": "13348",
"transaction_status": "approved",
"transaction_type": "sale",
"version": "1.2",
"signature": "a811f59493407babbb000d2cf117195b08426c5455d4cf13bd33909732365cfde2a03d6ba2daddb2175202ff33fe9072"
}Response (ERR)
{
"description": "Transaction not found",
"status": 1,
"timestamp": 1579210424,
"version": "1.2",
"signature": "6a16050382810aa983ca89bb8589124c04b056d4daadaa4f761c7d62873e3ab61a91bf4399af1c3e6e4c19e2608e54c7"
}Please refer to How to Build Signature for details on signing the request.
You are currently viewing version 3.4 Latest version here