Skip to main content
POST
/
validate-charge
Validate Charge
curl --request POST \
  --url https://api.flutterwave.com/v3/validate-charge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "otp": "12345",
  "flw_ref": "FLW-MOCK-f7a221903f699288569465135f357022"
}
'
{
  "status": "success",
  "message": "Charge validated",
  "data": {
    "id": 4981392,
    "tx_ref": "MC-3243ff00440011pu00",
    "flw_ref": "FLW-MOCK-f7a221903f699288569465135f357022",
    "device_fingerprint": "N/A",
    "amount": 100,
    "charged_amount": 100,
    "app_fee": 1.4,
    "merchant_fee": 0,
    "processor_response": "successful",
    "auth_model": "PIN",
    "currency": "NGN",
    "ip": "52.209.154.143",
    "narration": "CARD Transaction ",
    "status": "successful",
    "auth_url": "N/A",
    "payment_type": "card",
    "plan": null,
    "fraud_status": "ok",
    "charge_type": "normal",
    "created_at": "2024-03-21T22:16:28.000Z",
    "account_id": 20937,
    "customer": {
      "id": 2376560,
      "phone_number": null,
      "name": "John Doe",
      "email": "Johndoe@gmail.com",
      "created_at": "2024-03-21T22:16:28.000Z"
    },
    "card": {
      "first_6digits": "539983",
      "last_4digits": "8381",
      "issuer": "MASTERCARD GUARANTY TRUST BANK Mastercard Naira Debit Card",
      "country": "NG",
      "type": "MASTERCARD",
      "expiry": "10/31"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
otp
string
required
​
flw_ref
string
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data · object
required
Example:
{
  "id": 4973065,
  "tx_ref": "YOUR_UNIQUE_REFERENCE",
  "flw_ref": "FLW-MOCK-2477a2b9d7845b31976cd50c0af890f1",
  "device_fingerprint": "N/A",
  "amount": 100,
  "charged_amount": 100,
  "app_fee": 1.4,
  "merchant_fee": 0,
  "processor_response": "Please enter the OTP sent to your mobile number 080****** and email te**@rave**.com",
  "auth_model": "NOAUTH",
  "currency": "NGN",
  "ip": "52.209.154.143",
  "narration": "CARD Transaction ",
  "status": "successful",
  "auth_url": "https://ravesandboxapi.flutterwave.com/mockvbvpage?ref=FLW-MOCK-2477a2b9d7845b31976cd50c0af890f1&code=00&message=Approved.%20Successful&receiptno=RN1710749806478",
  "payment_type": "card",
  "plan": null,
  "fraud_status": "ok",
  "charge_type": "normal",
  "created_at": "2024-03-18T08:16:46.000Z",
  "account_id": 20937,
  "customer": {
    "id": 2373734,
    "phone_number": null,
    "name": "Anonymous customer",
    "email": "developers@flutterwavego.com",
    "created_at": "2024-03-18T08:16:46.000Z"
  },
  "card": {
    "first_6digits": "553188",
    "last_4digits": "2950",
    "issuer": "MASTERCARD  CREDIT",
    "country": "NG",
    "type": "MASTERCARD",
    "expiry": "09/32"
  }
}