Confirm Crypto Sent

Manually confirm that crypto has been sent for an off-ramp transaction.

Manually confirms that a user has sent crypto for an off-ramp transaction. Use this when the user sends crypto from an external wallet and you need to provide the transaction hash.

Endpoint

POST /v1/offramp/crypto-sent

Authentication

Header	Value
Authorization	<api_key> — Merchant API key (this endpoint is API-key only)

Request body

Field	Type	Required	Description
reference	string	Yes	Transaction reference (UUID)
settledCryptoAmount	number	Yes	Exact crypto amount that was sent
transactionHash	string	Yes	Blockchain transaction hash as proof

Example request

cURL

curl -X POST https://ramp-api.ivorypay.io/api/v1/offramp/crypto-sent \
  -H "Authorization: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "660e8400-e29b-41d4-a716-446655440001",
    "settledCryptoAmount": 62.5,
    "transactionHash": "0xdef456789abc..."
  }'

Node.js

const response = await fetch("https://ramp-api.ivorypay.io/api/v1/offramp/crypto-sent", {
  method: "POST",
  headers: {
    "Authorization": "your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    reference: "660e8400-e29b-41d4-a716-446655440001",
    settledCryptoAmount: 62.5,
    transactionHash: "0xdef456789abc...",
  }),
});

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

Python

import requests

response = requests.post(
    "https://ramp-api.ivorypay.io/api/v1/offramp/crypto-sent",
    headers={
        "Authorization": "your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "reference": "660e8400-e29b-41d4-a716-446655440001",
        "settledCryptoAmount": 62.5,
        "transactionHash": "0xdef456789abc...",
    },
)

print(response.json())

Go

package main

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

func main() {
	body, _ := json.Marshal(map[string]interface{}{
		"reference":           "660e8400-e29b-41d4-a716-446655440001",
		"settledCryptoAmount": 62.5,
		"transactionHash":     "0xdef456789abc...",
	})

	req, _ := http.NewRequest("POST", "https://ramp-api.ivorypay.io/api/v1/offramp/crypto-sent", bytes.NewBuffer(body))
	req.Header.Set("Authorization", "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

{
  "success": true,
  "message": "Crypto sent successful",
  "data": {
    "status": "MANUAL_CRYPTO_PAYMENT_SENT",
    "reference": "660e8400-e29b-41d4-a716-446655440001",
    "chain": "BSC_MAINNET",
    "expectedToken": "USDT",
    "context": "LIVE"
  }
}

IvoryPay will verify the transaction hash on-chain. If the hash is invalid or the amount doesn't match, the confirmation may be rejected.