Mastercard Routing API

The Routing API from Mastercard — 1 operation(s) for routing.

Documentation GitHub OpenAPI

Operations 1

POST /isRoutingValid Mastercard Bill Payment Validator Service Returns the Processing Status for a Potential Rpps Transaction

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/mastercard-routing-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Mastercard Bill Payment Validator Routing API
  description: This service is provided on behalf of the Mastercard Remote Payment and Presentment (RPPS) Bill Payment Processing Network, which supports consumer to business "push" bill payments (i.e. those which are not funded by debit/credit card transactions) in the U.S.
  version: '1.0'
  x-artifactId: billpay-api
  contact:
    name: Bill Pay Development Support
    email: Bill_Pay_Development_Support@mastercard.com
servers:
- url: https://sandbox.api.mastercard.com/billpayAPI/v1
tags:
- name: Routing
paths:
  /isRoutingValid:
    post:
      summary: Mastercard Bill Payment Validator Service Returns the Processing Status for a Potential Rpps Transaction
      description: Bill Payment Validator performs real time transaction validation against the specified Biller ID's account masks, account check digits and all other registered RPPS processing parameters.
      tags:
      - Routing
      responses:
        '200':
          description: The Bill Payment Validator response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillPayResponse'
        default:
          description: unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-samples:
      - name: example_billpay_routing_validation_request_explorer
        type: documentation
        request:
          application/json: "{\n    \"BillPayAccountValidation\": {\n      \"RppsId\": \"99887761\",\n      \"BillerId\": \"9998887771\",\n      \"AccountNumber\": \"1234567890\",\n      \"TransactionAmount\": \"250.00\",\n      \"CustomerIdentifier1\": \"\",\n      \"CustomerIdentifier2\": \"\",\n      \"CustomerIdentifier3\": \"\",\n      \"CustomerIdentifier4\": \"\",\n      \"ResponseString\": \"\"\n  }\n}"
        populateDefaults:
          application/json: "{\n  \"BillPayAccountValidation\": {\n    \"RppsId\": true,\n    \"BillerId\": true,\n    \"AccountNumber\": true,\n    \"TransactionAmount\": true\n  }\n}"
        response:
          application/json: "{\n    \"BillPayAccountValidation\": {\n      \"RppsId\": \"99887761\",\n      \"BillerId\": \"9998887771\",\n      \"AccountNumber\": \"1234567890\",\n      \"TransactionAmount\": \"250.00\",\n      \"CustomerIdentifier1\": null,\n      \"CustomerIdentifier2\": null,\n      \"CustomerIdentifier3\": null,\n      \"CustomerIdentifier4\": null,\n      \"ResponseString\": \"Successful\"\n  }\n}"
      - name: example_billpay_routing_validation_request
        request:
          application/json: "{\n    \"BillPayAccountValidation\": {\n      \"RppsId\": \"99887761\",\n      \"BillerId\": \"9998887771\",\n      \"AccountNumber\": \"1234567890\",\n      \"TransactionAmount\": \"250.00\",\n      \"CustomerIdentifier1\": \"\",\n      \"CustomerIdentifier2\": \"\",\n      \"CustomerIdentifier3\": \"\",\n      \"CustomerIdentifier4\": \"\",\n      \"ResponseString\": \"\"\n  }\n}"
        response:
          application/json: "{\n    \"BillPayAccountValidation\": {\n      \"RppsId\": \"99887761\",\n      \"BillerId\": \"9998887771\",\n      \"AccountNumber\": \"1234567890\",\n      \"TransactionAmount\": \"250.00\",\n      \"CustomerIdentifier1\": null,\n      \"CustomerIdentifier2\": null,\n      \"CustomerIdentifier3\": null,\n      \"CustomerIdentifier4\": null,\n      \"ResponseString\": \"Successful\"\n  }\n}"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillPayRequest'
        description: Contains the details of the get PAR API request message.
components:
  schemas:
    Error:
      properties:
        Source:
          type: string
          description: This is the unique identifier that attempts to define the field in error when available.  If a specific field can't be identified System will be returned.
          example: Atms.Atm.Location.Address.Line1
        ReasonCode:
          type: string
          description: This will identify the reason for the error.
    ErrorResponse:
      properties:
        Errors:
          $ref: '#/components/schemas/Errors'
    Errors:
      properties:
        Error:
          type: array
          items:
            $ref: '#/components/schemas/Error'
    BillPayRequest:
      properties:
        BillPayAccountValidation:
          $ref: '#/components/schemas/BillPayAccountValidation'
    BillPayResponse:
      properties:
        BillPayAccountValidation:
          $ref: '#/components/schemas/BillPayAccountValidation'
    BillPayAccountValidation:
      properties:
        RppsId:
          type: string
          description: Originator RPPS ID populated in the message.  The maximum length is 8
          example: '99887761'
        BillerId:
          description: Biller ID populated in the message. The maximum length is 10.
          type: string
          example: '9998887771'
        AccountNumber:
          description: Consumer account number populated in the message.  The minimum length is 8 and the maximum length is 22.
          type: string
          example: '1234567890'
        TransactionAmount:
          description: Amount populated in the message.
          type: string
          example: '250.00'
        CustomerIdentifier1:
          description: Consumer identifier populated in the message.
          type: string
          example: ''
        CustomerIdentifier2:
          description: Consumer identifier populated in the message.
          type: string
          example: ''
        CustomerIdentifier3:
          description: Consumer identifier populated in the message.
          type: string
          example: ''
        CustomerIdentifier4:
          description: Consumer identifier populated in the message.
          type: string
          example: ''
        ResponseString:
          description: Indicates if the bill payment transaction information passed all RPPS transaction processing edits for the specified biller ID or indicates errors. The minimum length is 0 and the maximum length is 120.
          type: string
          example: Successful

Mastercard Routing API

Operations 1

Documentation

Specifications

Code Examples

Other Resources