Skip to main content

PLATFORM_NAME API

The API has three parts: create payment, webhooks (payment status updates), and get payment by id.

Base URL​

https://api.sandbox.nd8.com/api

Use Sandbox or Production server in the API Reference; set API_BASE_URL and API_BASE_URL_SANDBOX when building for your environment.

1. Create payment​

Start a payment (hosted checkout):

  • POST /checkout/create/ — Requires API key. Send billing, currency, products; get back a checkout_url and token.
  • Redirect the customer to checkout_url to complete payment. When the payment completes or fails, use webhooks for the status and transaction_id, or call Get payment by id with that ID.

Details: Create payment.

2. Webhooks​

We send events to your endpoint when payment status changes (e.g. paid, failed, refunded). Configure Endpoint URL and Secret in the dashboard: Organization → API & Webhooks.

  • Event transaction.status_changed includes transaction_id, amount, status, currency, timestamps.
  • Verify requests with the X-Webhook-Signature header (HMAC-SHA256 of the raw body).

Details: Webhooks.

3. Get payment by id​

Retrieve a payment by ID (amount, status, currency, products, timestamps):

  • GET /transactions/<id>/ — Requires API key. Use the public ID (e.g. TXabc123) or numeric transaction ID.

Details: Get payment by id.