TR EN


Transaction Status Information



A request to learn the status of the sale/cancel/refund transactions. It is used in situations where your web site is unaware of the transaction due to browser or internet problems. get_param value must be TransactionStatus specially for this request. The ID information of the corresponding process is sent with the parameter merchant_trx_id.


Request parameters
merchant: required
merchant name which you created in your Payfull account.

type: required
Transaction type should be Get.

get_param: required
The name of the parameter you like to get, so it should be TransactionStatus.

language: required
Response message language can be en / tr

client_ip: required
The client IP who uses the application which sends the request to the API.

merchant_trx_id: required
This parameter is for defining and sending a unique id value for the operation. You need to use this value for Transaction Status Information that you generated before.

passive_data: optional
This parameter can take any passive data, then API will save it and return it to the caller in the response.

hash: required
Generated hash code on the caller side

To generate the hash code please follow the steps below:
  • - Arrange the parameters alphabetically from A to Z
  • - Create a parameters string which has the length for each parameters with its value side by side
  • - Create the sha256 hash code from the parameters string and pass the merchant password as Shared secret key
  • - Add the hash code to the request parameters


İstek Örneği


merchant: merchant name
type: Get
get_param: TransactionStatus
language: tr
client_ip: 192.168.1.1
transaction_id: P_F_e2da8f7c25_dbab58efe
hash: e34a9d3aa4312e43cae22573d21edf8d84ee9564



Sample request


{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":
[{
  "type":"Sale",
  "transaction_processor":"Moka",
  "transaction_id":"P_F_e2da8f7c25_dbab58efe"
  "transaction_status":"1",
  "total":"10.00",
  "currency":"TRY",
  "original_currency":"TL",
  "currency_rate":"1.0000",
  "currency_code":"949",
  "installments":"1",
  "mode":"TEST",
  "date":"20-02-2018 11:26:09",
  "client_ip":"78.186.146.107",
  "customer_firstname":"Faruk",
  "customer_lastname":"Cinemre",
  "customer_email":"faruk@payfullçcom",
  "customer_phone":"+95399999999",
  "customer_tc":"38770568598",
}]
}


PHP Example


<