---
agentTools:
  projectIndex: https://safehavenmfb.readme.io/llms.txt
---

# Verify Checkout Transaction

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Safe Haven IBS API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.sandbox.safehavenmfb.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/checkout/{referenceCode}/verify": {
      "get": {
        "summary": "Verify Checkout Transaction",
        "description": "",
        "operationId": "verify-checkout-transaction",
        "parameters": [
          {
            "name": "referenceCode",
            "in": "path",
            "description": "Checkout `referenceCode`  from Checkout.js",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"statusCode\": 200,\n    \"message\": \"Transaction Fetched Successfully.\",\n    \"data\": {\n        \"channels\": [\n            \"transfer\"\n        ],\n        \"_id\": \"692526ab6be50c00247a1617\",\n        \"client\": \"6874eb47aaad890024be3930\",\n        \"merchantName\": \"Primetech\",\n        \"oauthClientId\": \"264ba6ba7d38b62eac5c5750490e660a\",\n        \"referenceCode\": \"384248537\",\n        \"customer\": {\n            \"firstName\": \"John\",\n            \"lastName\": \"Doe\",\n            \"emailAddress\": \"johndoe@example.com\",\n            \"phoneNumber\": \"+2348032273616\"\n        },\n        \"currencyCode\": \"NGN\",\n        \"amount\": 100,\n        \"feeBearer\": \"customer\",\n        \"fees\": 5,\n        \"vat\": 0,\n        \"stampDuty\": 0,\n        \"customIconUrl\": \"https://safehavenmfb.com/assets/images/logo1.svg\",\n        \"redirectUrl\": \"https://safehavenmfb.com\",\n        \"webhookUrl\": \"\",\n        \"settlementAccount\": {\n            \"bankCode\": \"999240\",\n            \"accountNumber\": \"0117964837\"\n        },\n        \"settlementStatus\": \"00\",\n        \"settlementReference\": \"999240251125034729780771187942\",\n        \"channelDetails\": {\n            \"type\": \"transfer\",\n            \"providerReference\": \"692526ae6be50c00247a1618\",\n            \"bankCode\": \"999240\",\n            \"accountNumber\": \"6020001053\",\n            \"accountName\": \"Primetech Checkout\",\n            \"expiryDate\": \"2025-11-25T04:01:55.022Z\"\n        },\n        \"paymentDetails\": {\n            \"type\": \"transfer\",\n            \"sessionId\": \"999240251125034729780771187942\",\n            \"paymentReference\": \"999240251125034729780771187942\",\n            \"senderBankCode\": \"999240\",\n            \"senderAccountNumber\": \"0117964837\",\n            \"senderAccountName\": \"PRIMETECH\"\n        },\n        \"status\": \"Paid\",\n        \"isDeleted\": false,\n        \"createdAt\": \"2025-11-25T03:46:51.892Z\",\n        \"updatedAt\": \"2025-11-25T03:46:55.025Z\",\n        \"__v\": 0\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 200,
                      "default": 0
                    },
                    "message": {
                      "type": "string",
                      "example": "Transaction Fetched Successfully."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "channels": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "transfer"
                          }
                        },
                        "_id": {
                          "type": "string",
                          "example": "692526ab6be50c00247a1617"
                        },
                        "client": {
                          "type": "string",
                          "example": "6874eb47aaad890024be3930"
                        },
                        "merchantName": {
                          "type": "string",
                          "example": "Primetech"
                        },
                        "oauthClientId": {
                          "type": "string",
                          "example": "264ba6ba7d38b62eac5c5750490e660a"
                        },
                        "referenceCode": {
                          "type": "string",
                          "example": "384248537"
                        },
                        "customer": {
                          "type": "object",
                          "properties": {
                            "firstName": {
                              "type": "string",
                              "example": "John"
                            },
                            "lastName": {
                              "type": "string",
                              "example": "Doe"
                            },
                            "emailAddress": {
                              "type": "string",
                              "example": "johndoe@example.com"
                            },
                            "phoneNumber": {
                              "type": "string",
                              "example": "+2348032273616"
                            }
                          }
                        },
                        "currencyCode": {
                          "type": "string",
                          "example": "NGN"
                        },
                        "amount": {
                          "type": "integer",
                          "example": 100,
                          "default": 0
                        },
                        "feeBearer": {
                          "type": "string",
                          "example": "customer"
                        },
                        "fees": {
                          "type": "integer",
                          "example": 5,
                          "default": 0
                        },
                        "vat": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "stampDuty": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        },
                        "customIconUrl": {
                          "type": "string",
                          "example": "https://safehavenmfb.com/assets/images/logo1.svg"
                        },
                        "redirectUrl": {
                          "type": "string",
                          "example": "https://safehavenmfb.com"
                        },
                        "webhookUrl": {
                          "type": "string",
                          "example": ""
                        },
                        "settlementAccount": {
                          "type": "object",
                          "properties": {
                            "bankCode": {
                              "type": "string",
                              "example": "999240"
                            },
                            "accountNumber": {
                              "type": "string",
                              "example": "0117964837"
                            }
                          }
                        },
                        "settlementStatus": {
                          "type": "string",
                          "example": "00"
                        },
                        "settlementReference": {
                          "type": "string",
                          "example": "999240251125034729780771187942"
                        },
                        "channelDetails": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "example": "transfer"
                            },
                            "providerReference": {
                              "type": "string",
                              "example": "692526ae6be50c00247a1618"
                            },
                            "bankCode": {
                              "type": "string",
                              "example": "999240"
                            },
                            "accountNumber": {
                              "type": "string",
                              "example": "6020001053"
                            },
                            "accountName": {
                              "type": "string",
                              "example": "Primetech Checkout"
                            },
                            "expiryDate": {
                              "type": "string",
                              "example": "2025-11-25T04:01:55.022Z"
                            }
                          }
                        },
                        "paymentDetails": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "example": "transfer"
                            },
                            "sessionId": {
                              "type": "string",
                              "example": "999240251125034729780771187942"
                            },
                            "paymentReference": {
                              "type": "string",
                              "example": "999240251125034729780771187942"
                            },
                            "senderBankCode": {
                              "type": "string",
                              "example": "999240"
                            },
                            "senderAccountNumber": {
                              "type": "string",
                              "example": "0117964837"
                            },
                            "senderAccountName": {
                              "type": "string",
                              "example": "PRIMETECH"
                            }
                          }
                        },
                        "status": {
                          "type": "string",
                          "example": "Paid"
                        },
                        "isDeleted": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "createdAt": {
                          "type": "string",
                          "example": "2025-11-25T03:46:51.892Z"
                        },
                        "updatedAt": {
                          "type": "string",
                          "example": "2025-11-25T03:46:55.025Z"
                        },
                        "__v": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "61e69ed05b7bd4006a962eed:62a345731cf0920076ca2f96"
}
```