Skip to main content
POST
/
v1
/
ramp
/
subaccount
/
{id}
/
payments
Create payment
curl --request POST \
  --url https://staging-api.bullring.finance/v1/ramp/subaccount/{id}/payments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "amount": 1000,
  "currency": "brl",
  "note": "Milk x 5"
}'
{
  "id": "06506c54-8df0-4d5f-bdc0-50dbe29fb84e",
  "lightningInvoice": "lnbcrt17171u1p5qr8k8pp5...",
  "paymentHash": null,
  "paymentRequestAmount": 1000,
  "paymentRequestCurrency": "brl",
  "invoiceCurrency": "usdt",
  "invoiceAmount": 17171,
  "status": "unpaid",
  "note": "Milk x 5",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Subaccount ID (UUID)

Body

application/json
​
amount
number
required
Example:

1000

​
currency
string
required
Example:

"brl"

​
note
string
Example:

"Milk x 5"

Response

Payment created successfully

​
id
string<uuid>
required
Example:

"06506c54-8df0-4d5f-bdc0-50dbe29fb84e"

​
lightningInvoice
string
required
Example:

"lnbcrt17171u1p5qr8k8pp5..."

​
paymentRequestAmount
number
required
Example:

1000

​
status
string
required
Example:

"unpaid"

​
paymentHash
string | null
Example:

null

​
paymentRequestCurrency
string
Example:

"brl"

​
invoiceCurrency
string
Example:

"usdt"

​
invoiceAmount
number
Example:

17171

​
note
string
Example:

"Milk x 5"

​
createdAt
string<date-time>
​
updatedAt
string<date-time>