Two environments. One smooth journey from testing to live transactions.

GreenBanana APIs for Checkout provide a simple and consistent interface for integrating Buy Now, Pay Later functionality into your application. Below you’ll find the Base URLs you’ll target in each environment, followed by the core Payments endpoints and their purposes.

​
Base URLs

The Base URLs gives you a list of the root addresses you’ll use to send all API requests. Choose the Sandbox URL when developing and testing your integration, and switch to the Production URL when you’re ready to go live.

EnvironmentAPI URLDashboard Url
Sandboxhttps://api.staging.bnplx.iohttps://app.staging.bnplx.io
Productionhttps://api.bnplx.iohttps://app.bnplx.io

​
Sandbox

Your playground. Build, break, and perfect your integration here without any real-world consequences — it’s all fake money anyway.

What you get:

  • Test all API endpoints and webhooks
  • Simulate various transaction scenarios
  • Validate your integration logic
  • Train your team on the platform
  • Perform load testing (within reasonable limits)
  • Test error handling and edge cases

​
Production

The production environment is where real business happens. This is your live environment handling actual customer transactions and real money movements.

What Happens Here

  • Real customer transactions are processed
  • Live business analytics and reporting
  • Full compliance and security monitoring
  • Production-level support and monitoring
  • Real-time webhook notifications

Your Launch Path

  • Sandbox → Test everything
  • Validate → Make sure it works
  • Production → Flip the switch
  • Profit → Watch the money flow

​
Payments Endpoints

Everything you need to handle the complete payment lifecycle. Each endpoint accepts JSON requests and returns structured responses.

  1. Create Payment: Start a new payment request. Include order details, customer info, and payment preferences.
    POST {{url}} /payments

  2. Confirm Payment: Confirm payment after customer authentication. This locks in the payment method and terms.
    POST /payments//confirm

  3. Capture Payment: Capture authorized funds and settle the transaction. Money moves from customer to merchant.
    POST {{url}}/payments/{payment_id}/capture

  4. Cancel Payment: Cancel payment before capture. No money changes hands, customer is notified.
    POST {{url}}/payments/{payment_id}/cancel

  5. Refund Payment: Return money to customer. Support both full and partial refunds with automatic reconciliation.
    POST {{url}}/payments/{payment_id}/refund

Update the URL based on the environment you’re using.

​
Payment Pattern

Each endpoint returns clear success/error responses with detailed status codes and messages.

Ready to start? Check out our Account Setup.