Nuvei

Nuvei DCC API

Dynamic Currency Conversion. getDccDetails computes the converted amount and markup rate for a card BIN and currency pair so merchants can present a localized currency offer at checkout.

Nuvei DCC API is one of 9 APIs that Nuvei publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include DCC, Currency Conversion, and FX. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.nuvei.com/documentation/integration/server-to-server/server-to-server-introduction/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nuvei/refs/heads/main/openapi/nuvei-dcc-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/nuvei/refs/heads/main/capabilities/dcc-conversions.yaml

OpenAPI Specification

nuvei-dcc-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Nuvei DCC API
  description: Dynamic Currency Conversion. Compute a converted amount and markup rate for a card
    BIN against a target currency.
  version: "1.0"
  contact:
    name: Nuvei Developer Support
    url: https://docs.nuvei.com
servers:
- url: https://secure.safecharge.com/ppp/api/v1
  description: Production
- url: https://ppp-test.nuvei.com/ppp/api/v1
  description: Sandbox
tags:
- name: DCC
paths:
  /getDccDetails.do:
    post:
      tags:
      - DCC
      summary: Get DCC Details
      operationId: getDccDetails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/DccRequest"
      responses:
        "200":
          description: DCC quote
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DccResponse"
components:
  schemas:
    DccRequest:
      type: object
      required:
      - merchantId
      - merchantSiteId
      - amount
      - currency
      - timeStamp
      - checksum
      properties:
        sessionToken:
          type: string
        merchantId:
          type: string
        merchantSiteId:
          type: string
        clientRequestId:
          type: string
        amount:
          type: string
        currency:
          type: string
        bin:
          type: string
        originalCurrency:
          type: string
        timeStamp:
          type: string
        checksum:
          type: string
    DccResponse:
      type: object
      properties:
        dccDetails:
          type: object
          properties:
            originalAmount:
              type: string
            originalCurrency:
              type: string
            convertedAmount:
              type: string
            convertedCurrency:
              type: string
            exchangeRate:
              type: string
            markup:
              type: string
            expireTime:
              type: string
        status:
          type: string
        errCode:
          type: integer
        reason:
          type: string