Skip to main content
Stripe is a global payments platform that powers millions of businesses worldwide, with support for 135+ currencies and enterprise-grade infrastructure.

​
Processor Details

​
Integration Guide

1

Enable raw card handling

In Stripe integration settings, enable Handle card information directly
This setting requires approval from Stripe. For production, provide your PCI DSS certificate—contact your PayNext representative to obtain it. For Sandbox, you can test without getting this feature approved by Stripe.
2

Copy credentials

Log in to the Stripe Dashboard:
  • Copy Account ID from Settings → Account details
  • Copy Publishable key and Secret key from Developers → API keys
Publishable Key is required for Cash App Pay. Without it, Cash App Pay will not appear in checkout.
3

Add integration in PayNext

In Dashboard → Integrations, click Add new integration → Stripe → Connect
4

Enter credentials

  • Name: Label for this connection (e.g., “Stripe US”)
  • Account ID, API Key (Secret key), Publishable Key: Values from Stripe
  • Network Tokens: Enable if activated by your Stripe account manager
  • Adaptive Acceptance: Enable if activated (requires Network Tokens)
5

Configure webhooks

In Stripe Developers → Webhooks, create an endpoint with the PayNext webhook URL and subscribe to:
  • payment_intent.succeeded
  • payment_intent.payment_failed
  • payment_intent.processing
  • payment_intent.canceled
  • payment_intent.amount_capturable_updated
  • payment_intent.requires_action
  • refund.created
  • refund.failed
  • refund.updated
  • radar.early_fraud_warning.created
  • payment_attempt_record_entry.capture_settled
  • mandate.updated
mandate.updated reports when a customer revokes a mandate for a payment method that is charged off-session, such as Cash App Pay or Pix Automático. PayNext marks the payment method as revoked so it is no longer used for renewals. Without this event, PayNext keeps attempting renewals on a mandate the customer has already cancelled.
payment_attempt_record_entry.capture_settled delivers the Acquirer Reference Number (ARN) for settled charges via Stripe’s Payment Records API. This API is a Stripe beta that Stripe enables per account — contact your Stripe representative to have it enabled on your Stripe account. Without it, this event is not delivered and ARN is not captured for Stripe payments.
6

Copy webhook secret

Copy the Signing secret from Stripe and paste it into the Webhook Secret field in PayNext
7

Save

Click Connect to complete the integration

​
Metadata Mapping

Stripe supports full metadata mapping. Common use cases:

​
Testing

Stripe testing guide — Test cards, declines, and 3DS scenarios.