Endpoints: Payments
This reference lists the REST API endpoints used across the payments guide, grouped by functional area. Each path is relative to the base URL for your environment.
Server URLs
Use the base URL for your environment as the URL prefix.
| Environment | Base URL |
|---|---|
| Production | |
| Sandbox / Test |
Authorizations
The authorization service applies to standard authorizations and the authorization variants documented in this guide, including bill payment, Japanese payment options, and debt repayment. Incremental authorizations update an existing authorization.
- Authorizations ·
POST·/pts/v2/payments· - Authorizations with CVN ·
POST·/pts/v2/payments· - Authorizations with Line Items ·
POST·/pts/v2/payments· - Authorizations with Payment Network Tokens ·
POST·/pts/v2/payments· - Debit and Prepaid Authorizations ·
POST·/pts/v2/payments· - Debit and Prepaid Partial Authorizations ·
POST·/pts/v2/payments· - Zero Amount Authorizations ·
POST·/pts/v2/payments·
- Incremental Authorizations ·
PATCH·/pts/v2/payments/{id}·
- Debt Repayment ·
POST·/pts/v2/payments· - Final Authorization Indicators ·
POST·/pts/v2/payments· - SCA Exemption Authorizations ·
POST·/pts/v2/payments·
- Marketplace Authorizations with a Foreign Retailer ·
POST·/pts/v2/payments·
- Least-Cost Routing ·
POST·/pts/v2/payments· - Pre-Authorizations ·
POST·/pts/v2/payments· - Surcharge Authorizations ·
POST·/pts/v2/payments· - Visa Consumer Bill Payments ·
POST·/pts/v2/payments·
- Japanese Payment Options ·
POST·/pts/v2/payments· - Mastercard Bill Payments ·
POST·/pts/v2/payments· - Mastercard Expert Monitoring Solutions ·
POST·/pts/v2/payments· - Visa Bill Payments ·
POST·/pts/v2/payments·
Sales
The sale service combines authorization and capture into a single request.
- Sales ·
POST·/pts/v2/payments· - Sales with Payment Network Tokens ·
POST·/pts/v2/payments·
Payer Authentication
The payer authentication service verifies a cardholder's identity before authorization, using the scheme-specific programs supported for each partner.
- Discover ProtectBuy ·
POST·/pts/v2/payments· - Visa Secure ·
POST·/pts/v2/payments·
- American Express SafeKey ·
POST·/pts/v2/payments· - Mastercard Identity Check ·
POST·/pts/v2/payments·
- JCB J/Secure ·
POST·/pts/v2/payments·
Captures
The capture service captures an authorization. It applies to standard captures, multiple partial captures, forced captures, and foreign retailer captures.
- Captures ·
POST·/pts/v2/payments/{id}/captures·
- Marketplace Captures with a Foreign Retailer ·
POST·/pts/v2/payments/{id}/captures·
- Multiple Partial Captures ·
POST·/pts/v2/payments/{id}/captures·
- Forced Captures ·
POST·/pts/v2/payments·
- Split Shipments ·
POST·/pts/v2/payments/{id}/captures·
Authorization Reversals
The authorization reversal service reverses an authorization. Use the timeout reversal endpoint when the original authorization response was not received.
- Authorization Reversals ·
POST·/pts/v2/payments/{id}/reversals
- Partial Authorization Reversals ·
POST·/pts/v2/payments/{id}/reversals
- Timeout Authorization Reversals ·
POST·/pts/v2/reversals
Credits
The credit service processes stand-alone credits, including Mastercard Payment of Winnings.
- Stand-Alone Credits ·
POST·/pts/v2/credits/·
Refunds
The refund service processes follow-on refunds linked to a prior capture or sale.
- Refunds ·
POST·/pts/v2/payments/{id}/refunds
Voids
The void service cancels a capture, credit, refund, or sale before settlement. Use the timeout void endpoint when the original response was not received.
- Void a Payment ·
POST·/pts/v2/payments/{id}/voids· - Void a Capture ·
POST·/pts/v2/captures/{id}/voids·
- Void a Refund ·
POST·/pts/v2/refunds/{id}/voids·
- Void a Credit ·
POST·/pts/v2/credits/{id}/voids·
- Timeout Voids ·
POST·/pts/v2/voids/·
Thanks for your feedback!
Last published: October 28, 2026