Quickstart

This guide shows the fastest path to a working PayNowPro integration using the REST API.

Before you begin

You need an API key and tenant alias for your organization's self-hosted PayNowPro dashboard. Contact your dashboard administrator if you do not have access to these credentials. Keep them on your server. Do not place an API key in browser, mobile, or public client-side code.

Store the API key and tenant alias as environment variables in your server environment, not in source control.

API base URL

All public API requests use the production base URL:

https://api.paynowpro.com/api/v1

Create a payment intent on your server

When your customer starts checkout, send a POST request from a trusted server endpoint. Set the amount, order number, and description from data you control on the server; do not accept those values unchecked from the browser.

curl -X POST "https://api.paynowpro.com/api/v1/payments/intent" \
  -H "api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "tenantAlias": "YOUR_TENANT_ALIAS",
    "firstName": "Avery",
    "lastName": "Brown",
    "email": "avery@example.com",
    "amount": 49.99,
    "currencyCode": "840",
    "orderNumber": "order_123",
    "intentType": "CAPTURE",
    "receiptUrl": "https://example.com/orders/receipt",
    "returnUrl": "https://example.com/orders/complete",
    "paymentDescription": "Monthly service fee"
  }'

The response includes an intentId and its current status. Store the intent ID with your order. Use the payment-flow integration supplied for your account to continue checkout with that ID.

A return to your site is not, by itself, confirmation that the payment succeeded. Use your account's supported status or event mechanisms before you fulfil an order.

Choose the next guide

• Use Accept a one-time payment for capture and authorization flows.
• Use Create and manage subscriptions for recurring billing.
• Use API usage and authentication for request authentication and error responses.

Production checklist

Before accepting live payments:

• Keep API keys in server-side environment variables and rotate any key you believe was exposed.
• Validate products, prices, amounts, and order identifiers on your server.
• Confirm your production API key and tenant alias are configured for the correct organization.
• Record the PayNowPro IDs returned by the API alongside the corresponding records in your system.
• Test your confirmation, cancellation, and customer-support paths with your production payment configuration.