Praxis Wiki logo

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://gateway-test.praxispay.com/api/find-transaction
Live https://gateway.praxispay.com/api/find-transaction

REQUEST PARAMETERS

Variable Type Description
trace_id int(11) Required. Transaction identifier in Praxis
frontend varchar(256) Required. Cashier FrontEnd name, normally it is a common name of the website. Linked to a specific base currency.
merchant_id varchar(50) Required. Merchant API client account identifier
version varchar(3) 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
transaction_type varchar(8) Required. Transaction type. Allowed values are:
sale (deposit)
payout (withdrawal)
refund (return deposit funds)
transaction_status varchar(16) Required.

Deposit
- pending - processing initiated, final response expected from PSP
- authorized - transaction authorized, capture is expected
- approved - processing was successful
- declined - processing failed
- chargeback - customer requested to get funds back
- reversed - refund done at PSP side

Payout
- requested - merchant action/approval expected
- authorized - transaction authorized by manager, manual processing is expected
- in progress - processing at PSP side
- approved - processing was successful
- rejected - processing cancelled by the merchant or client
- reversed - refund done at PSP side
transaction_id varchar(50) Optional. Transaction identifier in PSP
trace_id int(11) Required. Transaction identifier in Praxis
order_id varchar(50) sale - Optional. Transaction identifier in your system
payout - Required. Transaction identifier in your system
frontend varchar(256) Required. Cashier FrontEnd name, normally it is a common name of the website. Linked to a specific base currency.
pin varchar(50) Required. Unique customer id in your system
amount int(20) Required. Processed amount in cents.
Please note: for certain currencies (JPY, CLP, KRW, VND, BHD, IQD, JOD, LYD, OMR, TND) the amount is sent as-in without being converted to cents, this is important if you multiply by 100 to send the amount in cents
currency varchar(10) Required. Payment currency
payment_method varchar(50) Required. Payment method
payment_processor varchar(50) Required. Payment processor
created_by varchar(50) Optional. Transaction was created by
merchant_id varchar(50) Required. Merchant API client account identifier
card_number varchar(16) Optional. Customer card number (4444 44** **** 1233)
card_type varchar(10) Optional. Customer card type (VISA, MC)
card_exp varchar(8) Optional. Customer card exp (10/2023)
account_identifier varchar(256) Optional. CRM account identifier
cascade_level int(2) Optional. Transaction retry number
is_cascade int(1) Optional. Is this transaction goes through cascade
error_code int(10) Optional. Error code for rejected transactions
error_details varchar(256) Optional. Error description for rejected transactions
reference_id varchar(256) Optional. ID of transaction to reverse
version int(11) Required. API version
timestamp varchar(3) Required. Response time. URL will be active during 1 min after this time
signature varchar(96) Required. Response 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://api.merchant.com/v1/api/find-transaction \
-H 'Content-Type: application/json' \
-d '{
    "frontend":"Praxis TEST USD",
    "merchant_id":"Test-Integration-Merchant",
    "timestamp":1568763057,
    "trace_id":1000000321,
    "version":"1.1",
    "signature":"9b9746639eba275f2351583bd71210706b9153cd571d07e5649cf26107ae451e7a9c0d8b127e97908abddd6a5624479e"
}'

Response (OK)

{
    "account_identifier":null,
    "amount":10300,
    "card_exp":null,
    "card_number":null,
    "card_type":null,
    "cascade_level":null,
    "created_by":"INTERNET",
    "currency":"USD",
    "description":"Transaction found",
    "edited_by":"INTERNET",
    "error_code":null,
    "error_desc":null,
    "order_id":null,
    "payment_method":null,
    "payment_processor":"PaySec",
    "pin":"27",
    "reference_id":null,
    "status":0,
    "timestamp":1568854175,
    "trace_id":1000000321,
    "transaction_id":null,
    "transaction_status":"approved",
    "version":"1.1",
    "signature":"158f74e35e4e37c8bb61e97d759c31fc1c0e71cabab394a60068d9a5ed50fa1543dbfa949a436e13ea3550458ddc7ec4"
}

Response (ERR)

{
    "description":"Transaction not found",
    "status":1,
    "timestamp":1560993181,
    "version":"1.1",
    "signature":"032b3e9204564c05d1767b5176f2345d95b33c03b42eb2414e1b7f61dd4d4a53c435670d42b533d679c49dee5ce9cc92"
}

Please refer to How to Build Signature for details on signing the request.