Create Transfer

Creates a new cross-border transfer. This endpoint deducts from your NGN or XOF balance and instantly routes the equivalent liquidity to the destination account.

POST /v1/transfers/create

Body Parameters

  • amount integer Required

    The amount to send in the lowest denomination (e.g., Kobo for NGN, Centimes for XOF).

  • currency string Required

    The currency you are sending. Valid options are NGN or XOF.

  • recipient string Required

    The KoriePay Agent ID, Phone Number, or mapped Bank Account of the receiver.

Example Request

curl https://api.koriepay.com/v1/transfers/create \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000000,
    "currency": "NGN",
    "recipient": "22790123456"
  }'

Example Response 200 ok 

{
  "status": true,
  "message": "Transfer queued successfully",
  "data": {
    "id": 928374,
    "status": "processing",
    "exchange_rate": 0.485
  }
}