Skip to main content

​
Creating a Payment for a New Merchant (Subaccount)

This guide outlines the steps to start accepting crypto payments for a new merchant using Bullring Finance.
💡 Note: You can start creating payment requests immediately after merchant registration. However, the merchant must complete verification and register a Pix key before any withdrawal can occur. See the Withdrawal Flow for details.

​
Step 1: Register a New Merchant

Send a request to the Create Subaccount endpoint to register the merchant by their email. 
POST /v1/ramp/subaccount
Body: 
{
  "email": "[email protected]"
}
Sample Response: 
{
  "id": "47a79c3d-9a2b-4998-898b-8eb7fad01526",
  "email": "[email protected]"
}

​
Step 2: Create a Payment Request

Once the merchant is registered, you can immediately begin generating invoices by calling the Create Payment endpoint. 
POST /v1/ramp/subaccount/{id}/payments
Body: 
{
  "amount": 1000,
  "currency": "brl",
  "note": "Milk x 5"
}
This returns a Lightning invoice your customer can use to complete the payment.

​
🔄 Test on Staging

Use regtestwallet.netlify.app to simulate payments in the staging environment. Make sure you’re using the x-api-key header and sending requests to: 
https://staging-api.bullring.finance
You’re now accepting crypto payments 🚀