Getting Started with GwalletPay

GwalletPay allows you to accept cryptocurrency payments and automatically receive payouts to your wallet.

API overview

GwalletPay provides a simple and predictable REST API.

Uses standard HTTP methods such as GET and POST
All responses are returned in JSON format
Designed for easy integration with any backend system

Prerequisites

Before you begin, make sure you have:

A GwalletPay account — sign up at https://pay.gwalletnodes.net/ and create your first store
Your API Key
A configured payout wallet
Basic understanding of REST APIs and HTTP requests

💡
Your payout wallet is required to receive funds after successful transactions.

Payment flow

Create a payment: Call POST /web/payments with the amount, currency and optional metadata.
Payment processing: GwalletPay processes the payment status from pending to succeeded or failed.
Webhook notification: A webhook event is sent to your server with the payment result.
Fulfill the order: Verify the webhook signature, confirm the payment succeeded and update your system accordingly.
Settlement: Funds will be settled to your payout address.

Integration methods

GwalletPay supports two integration approaches depending on your use case.

REST API (recommended)

Integrate directly with the GwalletPay REST API for full control over your payment flow.

Create payments programmatically using the API
Integrate with your application or backend
Receive real-time updates via webhooks

Server-to-server (white label)

For businesses that want complete control over the customer experience, GwalletPay supports a fully white-label integration where your customers interact only with your UI/UX.

Key benefits:

Full control over UI/UX and payment experience
No external redirects
Customers interact only with your platform
Create payments programmatically using the API
Integrate with your application or backend
Seamless integration with your existing system

📘
Start with the REST API for the fastest integration path. Use the white-label approach when you need full control over the customer-facing payment experience.