Skip to main content
POST
Create a payment

Authorizations

x-api-key
string
header
required

Nuvera API application secret key

Authorization
string
header
required

RS256 per-request signed JWT

Body

application/json
customerId
string
required

Customer making the payment

beneficiaryId
string
required

Beneficiary receiving the payment

amount
string
required

Payment amount

currencyCode
enum<string>
required

ISO 4217 currency code

Available options:
USD,
BRL,
MXN,
COP,
HKD,
CNY,
NGN,
KES,
MWK,
ZAR,
XOF,
XAF,
UGX,
TZS,
ZMW,
BWP,
SGD,
USDT,
USDC,
DAI,
BTC
purposeOfPayment
string
required

Purpose of payment

Minimum string length: 1
documentIds
string[]
required

IDs of uploaded documents (invoice required)

Minimum array length: 1
paymentQuoteId
string
required

ID of the active payment quote used for the payment

internalReference
string | null

Client's internal reference number

invoiceNumber
string

Invoice number

memo
string | null

Optional payment memo

Maximum string length: 64

Response

default - application/json
id
string
required
customerId
string
required
beneficiaryId
string
required
amount
string
required
currencyCode
string
required
internalReference
string | null
required
invoiceNumber
string | null
required
purposeOfPayment
string
required
memo
string | null
required
paymentToken
string | null
required
paymentNetwork
string | null
required
paymentQuoteId
string | null
required
status
string
required
createdAt
string
required
updatedAt
string
required
customer
object
beneficiary
object
sourceFunding
object
rail
object | null
receiptUrl
string | null
paymentQuote
object