Presentation logo

Payment API | Find Transaction


The transaction lookup request should be sent to https://gateway.praxispay.com/api/find-transaction. This API method will return the transaction inn the same format as the notification that was sent with the last transaction status change.

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 int(11) Required. API version
timestamp varchar(3) 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. pending - processing initiated, final response expected from PSP
requested - merchant action expected (approval)
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) 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 **** **** 1233)
card_type varchar(10) Optional. Customer card type (VISA, MC)
card_exp varchar(5) Optional. Customer card exp (22/10)
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/deposits/tx-1560610955 \
-H 'Content-Type: application/json' \
-d '{
    "frontend":"Praxis TEST USD",
    "merchant_id":"Test-Integration-Merchant",
    "timestamp":1560993066,
    "trace_id":"1000000321",
    "version":"1.1",
    "signature":"1bc2494247b5dc4bee996fe8ef2d954331cbc85a5b91f7fa37d510b4a439133ba26ce7af8aeb7e0096872e65e7707f7d"
}'

Response (OK)

{
    "account_identifier":null,
    "amount":"10300",
    "card_exp":null,
    "card_number":null,
    "card_type":null,
    "cascade_level":null,
    "created_by":"INTERNET",
    "currency":"CNY",
    "description":"Transaction found",
    "edited_by":null,
    "error_code":null,
    "error_desc":null,
    "order_id":null,
    "payment_method":null,
    "payment_processor":"PaySec",
    "pin":"27",
    "reference_id":null,
    "status":0,
    "timestamp":1560993122,
    "trace_id":"1000000321",
    "transaction_id":null,
    "transaction_status":"declined",
    "version":"1.1",
    "signature":"4a284bb330cd76f294980961b44338dd12d1f678b386573c3a8e0ba45f6707fd728f547e016054de23d6451f068b75b6"
}

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.