Query Virtual Account

Query a specific virtual account by account number.

Retrieves the details and current status of a virtual account from the payment processor.

Endpoint

POST /v1/virtual-accounts/query

Authentication

Header

Value

x-api-key

Your API key

Request body

Field

Type

Required

Description

accountNumber

string

Yes

Virtual account number to query

Example request

curl -X POST https://ramp-api.ivorypay.io/api/v1/virtual-accounts/query \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "accountNumber": "9900123456"
  }'

const response = await fetch("https://ramp-api.ivorypay.io/api/v1/virtual-accounts/query", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    accountNumber: "9900123456",
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://ramp-api.ivorypay.io/api/v1/virtual-accounts/query",
    headers={
        "x-api-key": "your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "accountNumber": "9900123456",
    },
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]string{
		"accountNumber": "9900123456",
	})

	req, _ := http.NewRequest("POST", "https://ramp-api.ivorypay.io/api/v1/virtual-accounts/query", bytes.NewBuffer(body))
	req.Header.Set("x-api-key", "your_api_key")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Query successful",
  "data": {
    "virtualAccountNumber": "9900123456",
    "virtualAccountName": "IvoryPay - User One",
    "bankName": "Providus Bank",
    "currency": "NGN",
    "status": "Enabled"
  }
}

PreviousList Virtual Accounts NextUpdate Virtual Account Status

Last updated 1 month ago

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]string{
		"accountNumber": "9900123456",
	})

	req, _ := http.NewRequest("POST", "https://ramp-api.ivorypay.io/api/v1/virtual-accounts/query", bytes.NewBuffer(body))
	req.Header.Set("x-api-key", "your_api_key")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

hashtagEndpoint

hashtagAuthentication

hashtagRequest body

hashtagExample request

hashtagExample response

Endpoint

Authentication

Request body

Example request

Example response