Nuvei

Nuvei Merchant Configuration API

Returns configuration data for a merchant including supported countries (getMerchantCountries) and the active set of payment methods per country (getMerchantPaymentMethods). Used by client checkouts to render dynamic payment selection.

Nuvei Merchant Configuration 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 Merchant, Configuration, Payment Methods, and Countries. 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-merchant-config-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/nuvei/refs/heads/main/capabilities/merchant-config-payment-methods.yaml

OpenAPI Specification

nuvei-merchant-config-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Nuvei Merchant Configuration API
  description: Returns configuration data for a merchant including supported countries and the
    payment methods enabled per country.
  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: Merchant
paths:
  /getMerchantCountries.do:
    post:
      tags:
      - Merchant
      summary: Get Merchant Countries
      operationId: getMerchantCountries
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/MerchantRequest"
      responses:
        "200":
          description: Country list
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/CountriesResponse"
  /getMerchantPaymentMethods.do:
    post:
      tags:
      - Merchant
      summary: Get Merchant Payment Methods
      operationId: getMerchantPaymentMethods
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/PaymentMethodsRequest"
      responses:
        "200":
          description: Payment methods list
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentMethodsResponse"
components:
  schemas:
    MerchantRequest:
      type: object
      required:
      - merchantId
      - merchantSiteId
      - timeStamp
      - checksum
      properties:
        merchantId:
          type: string
        merchantSiteId:
          type: string
        clientRequestId:
          type: string
        timeStamp:
          type: string
        checksum:
          type: string
    PaymentMethodsRequest:
      allOf:
      - $ref: "#/components/schemas/MerchantRequest"
      - type: object
        properties:
          countryCode:
            type: string
          currencyCode:
            type: string
          languageCode:
            type: string
          type:
            type: string
            enum: [DEPOSIT, WITHDRAWAL]
    CountriesResponse:
      type: object
      properties:
        status:
          type: string
        countries:
          type: array
          items:
            type: object
            properties:
              countryCode:
                type: string
              countryName:
                type: string
    PaymentMethodsResponse:
      type: object
      properties:
        status:
          type: string
        paymentMethods:
          type: array
          items:
            type: object
            properties:
              paymentMethod:
                type: string
              paymentMethodDisplayName:
                type: array
                items:
                  type: object
              countries:
                type: array
                items:
                  type: string
              currencies:
                type: array
                items:
                  type: string
              logoURL:
                type: string
              isDirect:
                type: boolean
              fields:
                type: array
                items:
                  type: object