Skip to main content

Create a Payment Button

Once your account is verified at Level 2, you can create a payment button from the ApoloPay dashboard. This generates the API keys you'll need for integration.

Creating the Button​

  1. Log in to the ApoloPay Dashboard
  2. Navigate to the Configuration section
  3. Click "Create Button"
  4. Enter a name for your button (e.g. "My Online Store", "Checkout Page") — this is just for your reference to identify the button
  5. Click "Continue"

After clicking continue, ApoloPay will generate two keys for you:

KeyPurposeWhere to use
Public KeyIdentifies your button on the frontendPassed as a prop to the SmartPay component
Private Key (Secret)Authenticates your backend API callsUsed in the x-secret-key header when calling the API
Keep your Private Key secure!

Never expose your Private Key in frontend code, public repositories, or client-side JavaScript. It should only be used on your server-side backend.

Configuring Webhooks (Optional)​

After creating the button, you can optionally configure a webhook to receive real-time notifications when a payment is completed:

  1. In the button settings, find the Webhook section
  2. Enter your Webhook URL — the endpoint on your server that will receive payment notifications (e.g. https://yourstore.com/api/webhooks/apolopay)
  3. A Webhook Secret will be generated — use this to verify that incoming webhook requests are genuinely from ApoloPay
tip

We highly recommend configuring webhooks for production environments. They provide reliable, server-to-server confirmation of payments, which is more secure than relying solely on frontend callbacks.

For more details on handling webhooks, see Webhooks →.

What You'll Need for Integration​

After creating your button, you'll have everything needed to integrate SmartPay:

ItemStatus
✅ Public KeyFor the frontend SDK component
✅ Private KeyFor backend API calls (create preorders)
✅ Webhook URL (optional)To receive payment confirmations
✅ Webhook Secret (optional)To verify webhook authenticity

Next Step​

Choose your frontend framework and follow the integration guide: