curl -X POST https://ramp-api.ivorypay.io/api/v1/buy \
-H "x-api-key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"firstName": "Kemi",
"lastName": "Adeyemi",
"email": "kemi@example.com",
"fiatAmount": 25000,
"fiatCurrency": "NGN",
"reference": "770e8400-e29b-41d4-a716-446655440002",
"redirectUrl": "https://yourapp.com/payment/complete"
}'const response = await fetch("https://ramp-api.ivorypay.io/api/v1/buy", {
method: "POST",
headers: {
"x-api-key": "your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
firstName: "Kemi",
lastName: "Adeyemi",
email: "kemi@example.com",
fiatAmount: 25000,
fiatCurrency: "NGN",
reference: "770e8400-e29b-41d4-a716-446655440002",
redirectUrl: "https://yourapp.com/payment/complete",
}),
});
const data = await response.json();
console.log(data);import requests
response = requests.post(
"https://ramp-api.ivorypay.io/api/v1/buy",
headers={
"x-api-key": "your_api_key",
"Content-Type": "application/json",
},
json={
"firstName": "Kemi",
"lastName": "Adeyemi",
"email": "kemi@example.com",
"fiatAmount": 25000,
"fiatCurrency": "NGN",
"reference": "770e8400-e29b-41d4-a716-446655440002",
"redirectUrl": "https://yourapp.com/payment/complete",
},
)
print(response.json())package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
body, _ := json.Marshal(map[string]interface{}{
"firstName": "Kemi",
"lastName": "Adeyemi",
"email": "kemi@example.com",
"fiatAmount": 25000,
"fiatCurrency": "NGN",
"reference": "770e8400-e29b-41d4-a716-446655440002",
"redirectUrl": "https://yourapp.com/payment/complete",
})
req, _ := http.NewRequest("POST", "https://ramp-api.ivorypay.io/api/v1/buy", 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))
}{
"statusCode": 200,
"success": true,
"message": "Buy initiated successfully",
"data": {
"firstName": "Kemi",
"lastName": "Adeyemi",
"email": "kemi@example.com",
"refCode": "buy123abc0",
"reference": "770e8400-e29b-41d4-a716-446655440002",
"transferDetails": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"accountName": "IvoryPay - Kemi Adeyemi",
"accountNumber": "9876543210",
"bank": "Providus Bank",
"amountPayable": 25000,
"expiresAt": "2026-03-26T13:00:00.000Z",
"currency": "NGN",
"businessFee": 0,
"platformFee": 125,
"createdAt": "2026-03-26T12:00:00.000Z",
"checkoutUrl": "https://checkout.ivorypay.io/pay/buy123"
}
}
}