unified-payments
  1. Unified Payments
unified-payments
  • Unified Payments
    • Overview
    • Encryption
    • Authentication
    • Card (Non-3DS)
    • Card (3DS)
    • Apple Pay
  • Unified Payments API
    • Payments
      • Initiate Payment
      • List Payments
      • Get Payment
    • Refunds
      • Initiate Refund
      • List Refunds
      • Get Refund
  • Schemas
    • Schemas
      • SuccessResponse
    • ErrorResponse
    • PaymentRequest
    • PaymentResponse
    • WebhookPayload
  1. Unified Payments

Overview

Unified Payments Documentation#

Quick start guides and API references for Nuvion's unified payment API.

Getting Started#

1.
Authentication - How to authenticate API requests
2.
Encryption - How to encrypt payment data
3.
Non-3DS Card Payments - Process card payments without 3DS
4.
3DS Card Payments - Process card payments with 3DS authentication
5.
Apple Pay Payments - Process Apple Pay payments

Quick Links#

Base URL (Sandbox): https://sandbox-acquiring.globalremitfs.com
Base URL (Production): https://acquiring.globalremitfs.com
Support: support@nuvion.com

Overview#

The unified payments API provides a single endpoint for all payment types:
POST /v2/payments
The payment flow is determined by the payment_method.type and the enable_3ds flag:
Payment Type3DSFlow
CardNoDirect payment (immediate result)
CardYesRedirect to 3DS challenge page
Apple PayN/ARedirect to Apple Pay page
All redirect-based flows return a challenge_url that you redirect your customer to.

Response Flow#

Direct Payment (Non-3DS Card)#

Merchant → POST /v2/payments → Immediate success/failure response

Redirect Payment (3DS, Apple Pay)#

1. Merchant → POST /v2/payments → Get challenge_url
2. Redirect customer → challenge_url → Customer completes auth
3. Nuvion redirects → merchant redirect_url → Payment complete
4. Webhook sent → merchant webhook_url → Payment confirmation

Need Help?#

Check the specific guide for your payment type
Review the Authentication guide if you're getting auth errors
Review the Encryption guide if you're getting decryption errors
Contact support@nuvion.com for additional help
Modified at 2025-11-10 16:54:35
Next
Encryption
Built with