TR EN


Capture Transaction



A capture transaction is designed to refer back to a previously processed Preauthorization transaction. The capture transaction will appear on the cardholder's statement.
Once a capture transaction is processed, the transaction proceeds will be settled into the merchant’s bank account following batch close.


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

type: required
Transaction type should be Capture.

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.

transaction_id: required
PreAuth transaction ID to be captured which is generated from Payfull

total: required
Total amount to be captured

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

merchant_trx_id: optional
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.

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


Sample request


merchant: merchant name
type: Capture
language: tr
client_ip: 192.168.1.1
transaction_id: T4U_8d8125d10a_481a77f38
total: 23.02
passive_data: just any passive data
hash: 14339MjuG01015018



Sample Response


{
"type":"Capture",
"status":1,
"transaction_id":"16252PRtA01010454",
"ErrorMSG":"Success Transaction",
"ErrorCode":"00",
"passive_data":"just any passive data",
"total":"1.00",
"currency":"TRY",
"bank_id":"Akbank",
"time":"08-09-2016 03:17:44"
}



PHP Example