Changelog

Summary

🚀 Currency Expansion & Recipient Management Enhancements: Added support for payout currencies and enhanced recipient management with currency-specific fields for better compliance and data management.

New Features

Payout Currencies Support

Get Currencies

• What’s New: Added payout_currencies array to the currencies reference endpoint
• Purpose: Returns the list of currencies that can be used for payouts in your organisation
• Benefits:
  • Enables clients to programmatically determine available payout currencies
  • Supports dynamic currency selection in payment workflows
  • Provides clear visibility into supported payout options

Enhanced Recipient Management

Add a New Recipient & Update a Recipient’s Account

• What’s New: Added additional_details object to both recipient creation and update payloads
• Purpose: Support currency-specific fields required for different payout currencies
• Key Features:
  • Flexible map structure for currency-specific information
  • Example structure:

    1
    "additional_details": {
    2
      "tax_id": "AH12345678"
    3
    }
  • Supported Currencies and Fields:
    • BRL (Brazilian Real): Tax ID must be provided in the tax_id field
    • KRW (South Korean Won): Business Registration number must be provided in the tax_id field
    • PKR (Pakistani Rupee): Identification number must be provided in the tax_id field
    • ISK (Icelandic Króna): Supported currency for currency-specific recipient payloads
  • Enables compliance with local regulatory requirements
  • Allows modification of tax identification numbers or registration details when updating recipients

Get Recipients & Get Recipient Details

• What’s New: Response now includes additional_details object
• Purpose: Retrieve tax identification numbers or registration numbers for recipients when available
• Key Features:
  • Returns currency-specific recipient information
  • Provides complete recipient profile including compliance data
  • Supports audit and compliance workflows

Breaking Changes

• None. All changes are additive and backward compatible.

Summary

🚀 Create Payment API Enhancement: The Create Payment API now supports optional FX conversion, allowing you to create same-currency payments without requiring a quote. FX conversion is optional - provide a quote_id only when currency conversion is needed.

API Updates

Create Payment

• Endpoint: POST /v3/customers/:customer_id/payments
• What’s New: FX conversion is now optional in the payment creation workflow
• Key Changes:
  • FX Conversion (Optional): If you need to convert currency, provide a quote_id from an active quote
    • The quote must be active and not expired
    • Quote validation ensures accurate FX rates and conversion amounts
  • Same Currency Payment: If no currency conversion is needed (same currency payment), do not send quote_id
    • Enables direct same-currency payments without requiring a quote
    • Streamlines payment creation for domestic or same-currency transfers

Usage Guidelines:

• For FX Conversion Payments: Include quote_id in the request payload. The quote must be active and not expired.
• For Same Currency Payments: Omit quote_id from the request payload. The payment will be processed without currency conversion.

Webhook Updates

Payment Status Updated Event

Updated payment status descriptions to clarify when each status applies:

Status Flow Differences:

• Same Currency Payments: Start with PROCESSING status immediately after payment creation
• FX Conversion Payments: Start with AWAITING_FUNDS status, then transition to RECEIVED_FUNDS when funds are received

Breaking Changes

• None. The quote_id field remains optional, maintaining backward compatibility with existing integrations.

Summary

📋 Legacy Payment APIs Documentation: Documented legacy v2 Payment API endpoints and provided migration guidance to help existing integrations transition to the improved v3 Payments API.

Legacy Payment APIs

Legacy APIs

• What’s New: Documented legacy v2 Payment API endpoints
• Purpose: Provide migration guidance for existing integrations
• Status: These endpoints remain functional but are no longer actively developed. New features and improvements are only available in the v3 Payments API.

Migration Guide

The following legacy endpoints have been superseded by v3 alternatives:

Benefits of Migrating to v3

The v3 Payments API provides several improvements over the legacy endpoints:

• Unified workflow: Combined FX conversion and payment creation in a single request
• Enhanced tracking: More detailed payment status information
• Bank transfer instructions: Dedicated endpoint for retrieving funding instructions
• Improved error handling: More detailed and actionable error responses
• Same-currency support: Handles both FX conversion and same-currency payments

Breaking Changes

• None. Legacy endpoints remain functional. However, we strongly recommend migrating to v3 for improved functionality and consistency.

Summary

Regulatory Compliance Updates: Added comprehensive guides for Confirmation of Payee (CoP) and Verification of Payee (VoP), covering all error codes, step-by-step resolution workflows, and updated API support for regulatory verification retries.

New Documentation

Regulatory Compliance Guides

• Confirmation of Payee (CoP) Guide: Complete guide covering CoP verification errors and their corresponding resolution workflows for UK payments.

• Verification of Payee (VoP) Guide: Complete guide covering VoP verification errors and their corresponding resolution workflows for EUR(SEPA) payments.

API Updates

New Request Fields

• confirm_recipient (optional): Added under recipient_details in the Create Payment API to allow retrying a payment for recipients that failed CoP or VoP checks
  • Enables retrying payments after CoP/VoP verification failures
  • Includes customer_action, request_identifier, and event_id fields

Summary

Third Party Customer Status Webhook: Added webhook notifications for third party customer status updates.

New Features

Third Party Customer Status Webhook

• What’s New: Platforms can now receive real-time webhook notifications when the status of a third party customer changes (e.g., from PENDING to APPROVED or REJECTED).
• How it Works: When a third party customer’s compliance status is updated, Redpin will send a webhook event to your configured endpoint with the latest status and customer reference.
• Benefits:
  • Enables instant updates to your platform when customer onboarding or compliance review is completed.
  • Reduces the need for polling the API for status changes.
• Event Payload Example:

  1
  {
  2
    "event_id": "3",
  3
    "event_timestamp": "2025-01-01T00:00:00Z",
  4
    "customer_id": "0201001008132685",
  5
    "client_customer_ref": "CUST_001",
  6
    "status": "APPROVED"
  7
  }
• Documentation: See Third Party Customer Webhook Events for integration details and setup instructions.

Bug Fixes

• N/A

Breaking Changes

• None. This is a non-breaking, additive change.

Summary

📖 New Integration Guides: Added comprehensive documentation to help developers integrate with Redpin’s APIs more effectively.

New Documentation

Integration Guides

• Getting Started: Overview of Redpin’s APIs and core payment workflows
• Making Your First Payment: Step-by-step tutorial for processing test payments
• Error Handling: Best practices for handling API errors and implementing retry logic
• Integration Guidelines: Complete guide for partners choosing integration approaches
• Sandbox to Production: Requirements and checklist for production deployment

Summary

🚀 New Third Party Customer APIs: Added APIs for property developers and real estate platforms to manage end-user customer profiles.

New Features

Create Third-Party Customer

• Api-Reference: Create Third Party Customer
• Endpoint: POST /api/v1/customers/{customer_id}/third-parties
• Purpose: Onboard end users (buyers/investors) for property transactions without creating direct Redpin customer relationships

Get Third-Party Customer

• Api-Reference: Get Third Party Customer
• Endpoint: GET /api/v1/customers/{customer_id}/third-parties/{client_customer_reference}
• Purpose: Retrieve customer profiles and compliance status for ongoing transaction management

Update Third-Party Customer

• Api-Reference: Update Third Party Customer
• Endpoint: PUT /api/v1/customers/{customer_id}/third-parties/{client_customer_reference}
• Purpose: Update customer information and trigger re-verification when needed

Create Payment Session API

• Endpoint: POST /api/v1/customers/:customer_id/sessions
• Purpose: Start a hosted payment session for cross-border payments.
• Highlights:
  • Generates a secure, time-limited session URL for embedding in your app or website
  • Supports multi-recipient payments with detailed recipient and bank account data
  • Configurable allowed origins and callback URLs for real-time status updates
  • Secured with OAuth 2.0 authentication
  • Sessions automatically expire at the defined timestamp; a new session must be created if the previous one expires before completion

Summary

🚀 New Recipient Management APIs: The B2B API suite now includes new endpoints to add, update, and retrieve recipient details, making it easier to manage business payments.

Recipient API Endpoints

Add Recipient

• Endpoint: POST /v2/customers/:customer_id/recipients.
• Purpose: Register a new recipient with personal and bank account details for future payments.
• Highlights:
  • Supports both individual and corporate recipients.
  • Collects comprehensive recipient information (name, contact, address, country).
  • Flexible bank account input: IBAN, account number + SWIFT, routing codes, and more.

Update Recipient

• Endpoint: PUT /v2/customers/:customer_id/recipients/:recipient_id.
• Purpose: Update an existing recipient’s details, such as contact information or bank account data.
• Highlights:
  • Modify recipient personal, contact, or bank details.
  • Maintain up-to-date records for compliance and payment accuracy.

Get All Recipients

• Endpoint: GET /v2/customers/:customer_id/recipients.
• Purpose: Retrieve a list of all recipients registered for a specific customer.
• Highlights:
  • List all recipients for a customer, including their details and status.
  • Supports pagination for large recipient lists.
  • Useful for displaying recipient options in your application.

Summary

🔔 New Webhook Events: Added webhook APIs for real-time status updates on customers, virtual accounts, and payments.

New Features

Customer Status Updated Webhook

• Event: customer_status_updated
• Purpose: Receive notifications when a customer’s status changes (e.g., active/inactive).
• Payload: Includes customer details, status, and required documents.

Virtual Account Status Updated Webhook

• Event: virtual_account_status_updated
• Purpose: Get notified when a virtual account becomes active or closed.
• Payload: Includes virtual account details, status, and bank information.

Payment Status Updated Webhook

• Event: payment_status_updated
• Purpose: Track the full payment journey with granular status updates (e.g., awaiting funds, FX completed, payout credited, etc.).
• Payload: Status-specific data for each payment event, including amounts, currencies, recipients, and more.

Summary

🚀 New API Endpoints: Added the “Create Quote” and “Get Recipient Details” APIs to the B2B API suite, enabling businesses to request currency quotations and retrieve recipient information for seamless payment processing.

New Features

Create Quote API

• Endpoint: POST /v1/customers/:customer_id/quotes
• Purpose: Request fixed price quotations for currency exchange
• Key Features:
  • Supports both BUY and SELL fixed side scenarios
  • Validates currency codes and amount precision
  • Returns comprehensive quote details with expiry timestamps
  • Provides real-time exchange rates and converted amounts
  • Includes detailed validation for supported currency combinations

Get Recipient Details API

• Endpoint: GET /v2/customers/:customer_id/recipients/:recipient_id
• Purpose: Retrieve detailed recipient information for payment processing
• Key Features:
  • Returns complete recipient profile including bank details
  • Supports both Individual and Corporate recipient types
  • Includes address validation and formatting standards
  • Provides comprehensive bank account information (IBAN, SWIFT, routing codes)
  • Returns recipient status and validation information

Technical Features

• Authentication: OAuth 2.0 Bearer token authentication required
• Validation: Comprehensive input validation with detailed error messages
• Documentation: Complete API documentation with practical examples
• Error Handling: Detailed error responses with field-level information
• Examples: Realistic request/response examples for seamless integration