Transaction Verification

After a charge is completed successfully, you should verify that the payment was successful with Flutterwave before giving value to your customer in your application. This serves as a failsafe, ensuring that the payment that was made is the payment you expected.

Here are some important things to check for when verifying the payment:

  • Verify that the transaction reference matches the one you generated
  • Verify that the status of the transaction is successful.
  • Verify that the currency of the payment was the expected currency
  • Verify that the amount paid was greater than or equal to the amount you expect. If the amount was greater, you can give the customer value and refund the rest.

To verify a payment, use the verify transaction endpoint, passing in the transaction ID in the URL. You can get the transaction ID from the data.id field that's present in the response you get after creating a transaction, and in the webhook payload for any transaction.

Here's how you'd verify a transaction in some of our backend SDKs:

// Install with: npm i flutterwave-node-v3

const Flutterwave = require('flutterwave-node-v3');
const flw = new Flutterwave(process.env.FLW_PUBLIC_KEY, process.env.FLW_SECRET_KEY);
flw.Transaction.verify({ id: transactionId })
    .then((response) => {
        if (
            response.data.status === "successful"
            && response.data.amount === expectedAmount
            && response.data.currency === expectedCurrency) {
            // Success! Confirm the customer's payment
        } else {
            // Inform the customer their payment was unsuccessful
        }
    })
    .catch(console.log);

// Install with: composer require flutterwavedev/flutterwave-v3

$flw = new \Flutterwave\Rave(getenv('FLW_SECRET_KEY')); // Set `PUBLIC_KEY` as an environment variable
$transactions = new \Flutterwave\Transactions();
$response = $transactions->verifyTransaction(['id' => $transactionId]);
if (
    $response['data']['status'] === "successful"
    && $response['data']['amount'] === $expectedAmount
    && $response['data']['currency'] === $expectedCurrency) {
    // Success! Confirm the customer's payment
} else {
    // Inform the customer their payment was unsuccessful
}

# Install with: gem install flutterwave_sdk

require 'flutterwave_sdk'

flw = Flutterwave.new(ENV["FLW_PUBLIC_KEY"], ENV["FLW_SECRET_KEY"], ENV["FLW_ENCRYPTION_KEY"])
transactions = Transactions.new(flw)
response = transactions.verify_transaction transaction_id
if response['data']['status'] === "successful" &&
    response['data']['amount'] === expected_amount &&
    response['data']['currency'] === expected_currency then
    # Success! Confirm the customer's payment
else
    # Inform the customer their payment was unsuccessful
end

curl --request GET 'https://api.flutterwave.com/v3/transactions/123456/verify' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_KEY'

You'll get a response that looks like this:

{
  "status": "success",
  "message": "Transaction fetched successfully",
  "data": {
    "id": 1163068,
    "tx_ref": "akhlm-pstmn-blkchrge-xx6",
    "flw_ref": "FLW-M03K-02c21a8095c7e064b8b9714db834080b",
    "device_fingerprint": "N/A",
    "amount": 3000,
    "currency": "NGN",
    "charged_amount": 3000,
    "app_fee": 1000,
    "merchant_fee": 0,
    "processor_response": "Approved",
    "auth_model": "noauth",
    "ip": "pstmn",
    "narration": "Kendrick Graham",
    "status": "successful",
    "payment_type": "card",
    "created_at": "2020-03-11T19:22:07.000Z",
    "account_id": 73362,
    "amount_settled": 2000,
    "card": {
      "first_6digits": "553188",
      "last_4digits": "2950",
      "issuer": " CREDIT",
      "country": "NIGERIA NG",
      "type": "MASTERCARD",
      "token": "flw-t1nf-f9b3bf384cd30d6fca42b6df9d27bd2f-m03k",
      "expiry": "09/22"
    },
    "customer": {
      "id": 252759,
      "name": "Kendrick Graham",
      "phone_number": "0813XXXXXXX",
      "email": "user@example.com",
      "created_at": "2020-01-15T13:26:24.000Z"
    }
  }
}

{
  "status": "error",
  "message": "No transaction was found for this id",
  "data": null
}

The transaction details are contained in the data object. For instance:

  • The status of the transaction is in data.status.
  • The details of the customer are in the data.customer field.
  • The data.charged_amount field says how much the customer was charged, while data.amount_settled tells you how much you will be receiving from this transaction.

Some fields will vary depending on the type of transaction; for instance, the card object will only be present for card transactions.

Loading...