Skip to main content
POST
/
v1
/
transfer-requests
/
{id}
/
confirm
Acknowledge that payment has been sent by the integrator
curl --request POST \
  --url https://api.railsfromthecrypt.com/v1/transfer-requests/{id}/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "payment_type": "full"
}
'
{
  "success": true,
  "message": "Payment confirmation received",
  "data": {
    "id": "c17d2777-e604-45e2-b6d5-7743652eadf1",
    "type": "onramp",
    "status": "fetching_rates",
    "source": {
      "amount": 10000,
      "currency": "NGN"
    },
    "destination": {
      "amount": 0,
      "currency": "USDC"
    },
    "events": [
      {
        "status": "pending",
        "timestamp": "2023-11-07T05:31:56Z",
        "completed_at": "2023-11-07T05:31:56Z"
      }
    ],
    "payments": [],
    "created_at": "2025-10-10T09:15:21Z",
    "reference": "TXN-2Z82FVYO6BW22RC7",
    "rate": {
      "value": 0,
      "expires_at": null
    },
    "recipient": {
      "id": "rec_01J8V9ZP3A7",
      "type": "crypto",
      "name": "My USDT Wallet",
      "details": {
        "network": "Polygon",
        "wallet_address": "0xABC123DEF456...",
        "symbol": "USDT"
      }
    },
    "payment_instructions": {
      "type": "bank_transfer",
      "bank_transfer": {
        "account_number": "1234567890",
        "account_name": "HashRails Ltd",
        "bank_name": "Wema Bank",
        "bank_code": "035"
      }
    }
  }
}
Notify Hashrails that you have initiated payment for a transfer request. You can confirm either a full or partial payment.
This endpoint serves as a payment notification. Actual settlement is triggered when the payment is detected via bank or blockchain confirmation.

Headers

​
x-api-key
string
required

API key for authentication

​
x-idempotency-key
string
required

UUID v4 idempotency key to prevent duplicate confirmations.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

​
id
string
required

Unique transfer request ID

Example:

"c17d2777-e604-45e2-b6d5-7743652eadf1"

Body

application/json

Acknowledge that the full payment amount has been sent.

​
payment_type
enum<string>
required
Available options:
full
Example:

"full"

Response

Payment confirmation received

​
success
boolean
Example:

true

​
message
string
Example:

"Payment confirmation received"

​
data
object