> For the complete documentation index, see [llms.txt](https://fintechbiz-solutions.gitbook.io/fintechbiz-solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fintechbiz-solutions.gitbook.io/fintechbiz-solutions/transaction/editor-1.md).

# Validate Transaction

<mark style="color:green;">`POST`</mark> <https://fintechbizsolutions.com/api/transaction/validate&#x20>;

**Headers**

| Name          | Value               |
| ------------- | ------------------- |
| Content-Type  | `application/json`  |
| Authorization | `Bearer SECRET_KEY` |

**Body**

<table><thead><tr><th width="165">Name</th><th width="94">Type</th><th>Description</th></tr></thead><tbody><tr><td>api_key*</td><td>string</td><td>API key</td></tr><tr><td>reference*</td><td>string</td><td>transaction reference</td></tr><tr><td>orderid*</td><td>string</td><td>transaction order id</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200: OK" %}

```json
{
  "data" : {
    "trxDetails" : {
        "status" : "approved",
        "trxRef" : "ajnsnssalalala",
        "orderid" : "FT-1192919ANAJ928282",
        "amount" : "10.00",
        "currency" : "USD",
        "transDate" : "2023-11-19 21:10:22"
    },
    "custDetails" : {
        "fullName" : "Alan Smith",
        "email" : "alansmith@gmail.com",
        "phone" : "9292974876",
    },
    "cardDetails" : {
        "cardType" : "MASTERCARD",
        "cardNumber" : "5432**********6789",
        "expiryDate" : "01/29"
    }
  }    
  "message": "success",
  "status": "success"
 }
```

{% endtab %}

{% tab title="400: Bad Request" %}

```json
{
    "status" : "failed",
    "message" : "Bad Request"
}
```

{% endtab %}

{% tab title="401: Unauthorized" %}

```json
{
    "status" : "failed",
    "message" : "Invalid Secret key"
}
```

{% endtab %}
{% endtabs %}