Skip to main content
POST
/
v1
/
payments
/
send
Send payment
curl --request POST \
  --url https://api.platnova.com/v1/payments/send \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "from_amount": 100.5,
  "from_wallet_id": "43a2b75e-5c59-429e-872a-2a54c7b17e37",
  "to_currency": "NGN",
  "payment_method": "bank_transfer",
  "info": {
    "account_number": "0123456789",
    "bank_code": "058",
    "account_name": "John Doe"
  },
  "is_save_to_beneficiary": false,
  "reference": "txn-001",
  "payment_type": {
    "type": "instant"
  }
}
'
{
  "status": true,
  "data": {
    "transaction_ref": "<string>",
    "status": "<string>",
    "from_amount": 123,
    "to_amount": 123,
    "from_currency": "<string>",
    "to_currency": "<string>",
    "method": "<string>",
    "created_at": "<string>"
  },
  "error": [
    "<unknown>"
  ],
  "message": "<string>"
}

Overview

Send a payment using the specified payment method. Supported methods include bank_transfer, card, mobile_money, tag_transfer (wallet-to-wallet), defi, revolut, paypal, ussd, cashapp, and zelle. Provide from_amount, from_wallet_id, to_currency, payment_method, and info (recipient details; fields depend on the method). For tag transfer, info must include tag_id. Payments can be instant, scheduled, or recurring.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
from_amount
number
required

Amount to send (source currency)

Required range: x >= 0.01
from_wallet_id
string
required

Wallet ID to debit from

to_currency
string
required

Destination currency (e.g. NGN, USD)

payment_method
string
required

One of: card, bank_transfer, mobile_money, wallet, tag_transfer, defi, revolut, paypal, cashapp, zelle, ussd

info
object
required

Recipient details; required fields depend on payment_method (e.g. account_number, bank_code, account_name for bank_transfer; tag_id for tag_transfer)

is_save_to_beneficiary
boolean

Save recipient as beneficiary

reference
string

Idempotency or client reference

document
string

Base64-encoded document (e.g. invoice)

payment_type
object
approver
string

Account UID to notify for approval (non-owner)

Response

Payment initiated successfully

status
boolean
data
object
error
any[]
message
string