August 2025
2025.08.29
Documentation additions
- Added a topic on detailed payment failure codes to help explain why a payment failed and how to resolve the issue
Documentation updates
- Updated payment failure reasons with new values
- Added new magic values for testing refund workflows
- Added a new payment error code
(
290207) for missing required parameters - Added new RFI error codes (
290302,290303,290304,290305) for RFI verification failures
API updates
-
Added the optional
quoteOptionsfield to thePOST /v1/cpn/quotesendpoint to support additional quote options when creating a quote. -
Updated the allowed values for
failureReasonfor payments and transactions to reflect new failure reasons. -
Added
failureCodeto the response of the following endpoints:
July 2025
2025.07.25
Added full DevDocs for OFIs for Circle Payments network:
Documentation additions
Added the following topics for CPN:- CPN Overview
- Integration Concepts
- Quickstart: Integrate with CPN as an OFI
- How-to: Set up Webhook Notifications
- How-to: Verify Webhook Signatures
- How-to: Request Payment Configurations and Routes
- How-to: Integrate with JSON Schema
- How-to: Encrypt Travel Rule and Beneficiary Data
- How-to: Create an Onchain Transaction
- How-to: Encrypt Files for RFI Transmission
- How-to: Create a Support Ticket
- Supported Blockchains
- Wallet Provider Compatibility
- Component States and Workflows
- Magic Values for Testing
- Webhook Events
- Webhook Retries
- Payment and Transaction Failure Reasons
- Error Codes
- JSON Schema
- RFI Levels
- Travel Rule Requirements
- Payment Reference
- Validating Brazilian Tax ID and Bank Account Numbers
API additions
Added the following CPN endpoints:GET /v1/cpn/configurations/overviewGET /v1/cpn/configurations/routesPOST /v1/cpn/quotesGET /v1/cpn/quotes/{quoteId}GET /v1/cpn/paymentsPOST /v1/cpn/paymentsGET /v1/cpn/payments/{paymendId}GET /v1/cpn/payments/{paymentId}/refunds/{refundId}GET /v1/cpn/payments/requirementsPOST /v1/cpn/payments/{paymentId}/transactionsGET /v1/cpn/payments/{paymentId}/transactions/{transactionId}POST /v1/cpn/payments/{paymentId}/transactions/{transactionId}/submitPOST /v1/cpn/payments/{paymentId}/transactions/accelerateGET /v1/cpn/payments/{paymentId}/rfis/{rfiId}POST /v1/cpn/payments/{paymentId}/rfis/{rfiId}/submitPOST /v1/cpn/payments/{paymentId}/rfis/{rfiId}/filesPOST /v1/cpn/supportTickets