Mastercard Subscriptions API

The Subscriptions API from Mastercard — 4 operation(s) for subscriptions.

Documentation GitHub OpenAPI

Operations 5

POST /subscriptions Mastercard Subscriptions to Accounts to Automatically Receive Notifications When an Update to an Account Occurs. #

GET /subscriptions Retrieving subscriptions #

GET /subscriptions/{id} Retrieving subscription by id #

PUT /subscriptions/{id} Updating subscription #

DELETE /subscriptions/{id} Deleting subscription #

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-subscriptions-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 Subscriptions API
  contact:
    url: https://developer.mastercard.com/support
    name: API Support
    email: apisupport@mastercard.com
  version: '1.0'
  description: 'Operations tagged Subscriptions across 2 of this provider''s published API definitions: mastercard-automatic-billing-updater-api-openapi.yml, mastercard-commercial-event-notifications-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- description: Production (open dropdown)
  url: https://api.mastercard.com/abu/accounts/
- description: Sandbox (open dropdown)
  url: https://sandbox.api.mastercard.com/abu/accounts/
- url: https://api.mastercard.com/commercial-event-notifications
  description: Production server URL
- url: https://sandbox.api.mastercard.com/commercial-event-notifications
  description: Sandbox server URL
tags:
- name: Subscriptions
paths:
  /subscriptions:
    post:
      summary: Mastercard Subscriptions to Accounts to Automatically Receive Notifications When an Update to an Account Occurs.
      tags:
      - Subscriptions
      description: A subscription request is used to watch an account. When an update is made available from the issuing banks, ABU will send a notification to the ABU Integrator's URI with the updated account information automatically. ABU will respond with the latest account information as well as subscribing the ABU Integrator to any future update notifications.
      operationId: accountSubscription
      requestBody:
        $ref: '#/components/requestBodies/SubscriptionRequest'
      responses:
        '202':
          $ref: '#/components/responses/SubscriptionResponse'
        '400':
          $ref: '#/components/responses/BadRequestErrorResponse'
        '401':
          $ref: '#/components/responses/UnauthorizedErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    get:
      summary: Retrieving subscriptions
      description: Retrieve the subscriptions defined for this client.
      tags:
      - Subscriptions
      operationId: getAllSubscriptions
      parameters:
      - $ref: '#/components/parameters/subscriptionsOffsetParam'
      - $ref: '#/components/parameters/subscriptionsLimitParam'
      - $ref: '#/components/parameters/sortParam'
      responses:
        '200':
          $ref: '#/components/responses/GetSubscription'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
    servers:
    - description: Production (open dropdown)
      url: https://api.mastercard.com/abu/accounts/
    - description: Sandbox (open dropdown)
      url: https://sandbox.api.mastercard.com/abu/accounts/
  /subscriptions/{id}:
    get:
      summary: Retrieving subscription by id
      description: Retrieve the details of a subscription.
      tags:
      - Subscriptions
      operationId: getSubscription
      parameters:
      - $ref: '#/components/parameters/subscriptionIdParam'
      responses:
        '200':
          $ref: '#/components/responses/GetSubscriptionsById'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      summary: Updating subscription
      description: Update an existing subscription.
      tags:
      - Subscriptions
      operationId: updateSubscription
      parameters:
      - $ref: '#/components/parameters/subscriptionIdParam'
      requestBody:
        $ref: '#/components/requestBodies/UpdateSubscription'
      responses:
        '200':
          $ref: '#/components/responses/UpdatedSubscription'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      summary: Deleting subscription
      description: Deletes a subscription, with the effect that no further notifications will be generated for that subscription.
      tags:
      - Subscriptions
      operationId: deleteSubscription
      parameters:
      - $ref: '#/components/parameters/subscriptionIdParam'
      responses:
        '204':
          description: No content, indicates that the subscription has been deleted successfully
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    servers:
    - url: https://api.mastercard.com/commercial-event-notifications
      description: Production server URL
    - url: https://sandbox.api.mastercard.com/commercial-event-notifications
      description: Sandbox server URL
components:
  examples:
    BadRequestExample:
      value:
        Errors:
          Error:
          - Source: Validation
            ReasonCode: ICA_VALUE_REQUIRED
            Description: ICA required for ABU client eligibility validation.
            Recoverable: false
            Details: ICA is mandatory.
    AccountInquiryExpiry:
      value:
        responseIndicator: EXPIRY
        account:
          number: '5573491171027315'
          expiry: '1221'
    AccountInquiryNonParticipating:
      value:
        responseIndicator: NON_PARTICIPATING
    AccountInquiryValid:
      value:
        responseIndicator: VALID
    AccountInquiryUnknown:
      value:
        responseIndicator: UNKNOWN
    AccountInquiryAccountUpdate:
      value:
        responseIndicator: ACCOUNT_UPDATE
        account:
          number: '5573491171029999'
          expiry: '1221'
    UnauthorizedExample:
      value:
        Errors:
          Error:
          - Source: Security.Credential
            ReasonCode: AUTHENTICATION_FAILED
            Description: Unauthorized Access to Web Service.
            Recoverable: false
            Details: No ICA configured for clientID
    AccountInquiryContact:
      value:
        responseIndicator: CONTACT
    ICMPProvisioningSubscriptionResponse:
      value:
        id: 0CNSa56c4e01133b472a532678ab1e02b394de1886b3692eb42c99287ef10cffa59c1720083461
        name: TestSubscription_ICMPTokenProvisioning
        subjectType: TOKEN_PROVISIONING_EVENT
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNSb12ce4d40ae45a3ff9cb9928f66ded61345e1cd45fc8d4991a0ce200d2b11ee11720083461
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1AD42C3FCAF12726E06368459E0A9487
            name: purchaseRequest.rcnAlias
            displayName: Purchase Request RCN Alias
            subjectType: TOKEN_PROVISIONING_EVENT
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    CreateICMPLifecycleSubscription:
      value:
        name: TestSubscription_ICMPTokenLifeCycle
        subjectType: TOKEN_LIFECYCLE_EVENT
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    BPCAuthorizationSubscriptionResponse:
      value:
        id: 0CNS5f3aee95730c70a70ca85cb66f13ac40eeb79c6bc508cbe58e1c74ae97f18bb01718868027
        name: TestSubscription_BPCAuth
        subjectType: BPC_PAYMENT_AUTHORIZATION
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNSa14d1f4baaadae35a8a83f65bb74914b002fbab44b4abf47039b687d5149fc3b1718868027
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1360ACE9C4D4CBFEE06368459E0ADD50
            name: virtualPaymentCard.number
            displayName: VirtualPaymentCard Number
            subjectType: BPC_PAYMENT_AUTHORIZATION
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: '1234567890123456'
            contentType: TEXT
    CreateICCPClearingSubscription:
      value:
        name: TestSubscription_ICCPClearing
        subjectType: CLEARING
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: test rcn alias
            contentType: TEXT
    CreateBPCAuthorizationSubscription:
      value:
        name: TestSubscription_BPCPaymentAuthorization
        subjectType: BPC_PAYMENT_AUTHORIZATION
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: virtualPaymentCard.number
          fieldOperator: EQUALS
          expectedContent:
            value: '1234567890123456'
            contentType: TEXT
    ICCPAuthorizationSubscriptionResponse:
      value:
        id: 0CNSf829c8c968765f86f51418c28d6b0430daa657174c3920a474890e540be5495d1718867617
        name: TestSubscription_ICCPAuth
        subjectType: PAYMENT_AUTHORIZATION
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNSa6d4b038aa40e844f3e521e8062c242de051c72be96cbc206666ea467069e9401718867617
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 0CNSa6d4a329d377bb296957df43e9f2f1ab5b35c997f88bcbc34939bc1525990be51556724071
            name: virtualpaymentcard.number
            displayName: VirtualPaymentCard Number
            subjectType: PAYMENT_AUTHORIZATION
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: '1234567890123456'
            contentType: TEXT
    GetSubscriptionICMPResponse:
      value:
        id: 0CNS8d3bb4d6a02504515a15c631eb60d03de5b9cf760348439320b4fdc135ef1e111719205036
        name: TestICMPProvisioningSubscription
        subjectType: TOKEN_PROVISIONING_EVENT
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNSfb3b539f47e9b95a267237c801e8818fd44b5b3c6aa957275bfd4d6dc9e9b2901719205036
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1AD42C3FCAF22726E06368459E0A9487
            name: purchaseRequest.companyId
            displayName: Purchase Request Company Id
            subjectType: TOKEN_PROVISIONING_EVENT
            contentType: INTEGER
          fieldOperator: EQUALS
          expectedContent:
            value: 248947
            contentType: INTEGER
        - id: 0CNSfe566e15084e64a9c2baa0183aaa8b901ac6defebf5f413365ecad64ab604ec11721373472
          name: OpenAPITest_SUBSC_NAME_DONT_DELETE1790226083
          subjectType: TOKEN_LIFECYCLE_EVENT
          subscriberId: A49875790BBF5F19E0535B449E0A5014
          active: true
          specifications:
          - id: 0CNS658f593db73c43ff9a1cc28a9053007ffdba8894649ce9d34f9cdedf430939eb1721373472
            type: FIELD
            operator: WHERE
            children: []
            fieldMapping:
              id: 1B9E8BCF021563E6E06368459E0AB38F
              name: purchaseRequest.rcnAlias
              displayName: Purchase Request RCN Alias
              subjectType: TOKEN_LIFECYCLE_EVENT
              contentType: TEXT
            fieldOperator: EQUALS
            expectedContent:
              value: RcnAliasText
              contentType: TEXT
    CreateBPSPaymentUpdateSubscription:
      value:
        name: TestSubscription_ICCPPaymentUpdate
        subjectType: PAYMENT_UPDATE
        active: true
        specifications: []
    ICMPLifecycleUpdatedSubscriptionResponse:
      value:
        id: 0CNSa56c4e01133b472a532678ab1e02b394de1886b3692eb42c99287ef10cffa59c1720083461
        name: TestSubscription_ICMPTokenProvisioningUpdated
        subjectType: TOKEN_LIFECYCLE_EVENT
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS63299c1c2fcd133327b88e12457b67333543ba4be3c1f77880b3fb99e25e31421720087279
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1AD42C3FCAF12726E06368459E0A9487
            name: purchaseRequest.rcnAlias
            displayName: Purchase Request RCN Alias
            subjectType: TOKEN_LIFECYCLE_EVENT
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    UpdateICMPLifecycleSubscription:
      value:
        name: TestSubscription_ICMPTokenProvisioningUpdated
        subjectType: TOKEN_LIFECYCLE_EVENT
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    UpdateICCPClearingSubscription:
      value:
        name: TestSubscription_ICCPClearing_Updated
        subjectType: CLEARING
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: test rcn alias
            contentType: TEXT
    GetSubscriptionBPCResponse:
      value:
      - id: 0CNS2f3a8d6bbda7dcc282e0946a9b886231c99fd2e53ab8d3ca9c35144412c590121712030697
        name: TestSubscription_BPC
        subjectType: BPC_PAYMENT_AUTHORIZATION
        subscriberId: 0CED10E7921EFFF6E06368459E0AD156
        active: true
        specifications:
        - id: 0CNS9f5a947e901b39a123ed6a9cf2cbedcf019d5880f6d65321c78e89a546043f6f1712030697
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 141747A087B5DC9DE06368459E0AC116
            name: corpGuid
            displayName: CorpGuid
            subjectType: BPC_PAYMENT_AUTHORIZATION
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: SENTTYA75A95EEE00B3DC279FCBF82AC3CD834F9C6DDCEFA44B22CEBF842EF4E9750921701908872
            contentType: TEXT
    GetSubscriptionICCPResponse:
      value:
      - id: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724070
        name: TestSubscription_PaymentAuthorization
        subjectType: PAYMENT_AUTHORIZATION
        subscriberId: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724071
        active: true
        specifications:
        - id: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724072
          type: FIELD
          operator: WHERE
          fieldMapping:
            id: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724073
            name: purchaseRequest.rcnAlias
            displayName: Purchase request RCN alias
            subjectType: PAYMENT_AUTHORIZATION
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            contentType: TEXT
            value: Travel Expense RCN
            anotherValue: {}
          children:
          - string
      - id: ABSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724070
        name: TestSubscription_PaymentUpdate
        subjectType: PAYMENT_UPDATE
        subscriberId: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724071
        active: true
        specifications: []
      - id: 0CNS00773977af91478d9a21643947955dbbb7038e4958bda83e308689725096c4ac1712210079
        name: TestSubscription_Clearing
        subjectType: CLEARING
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS9cc3a869f3010b380f72ebd92001cad9c0c7446609895f30b020f8e7e6aae7cc1712210079
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 135E59332C54BF9AE06368459E0ACEF0
            name: purchaseRequest.rcnAlias
            displayName: purchaseRequest rcnAlias
            subjectType: CLEARING
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: RcnAliasText
            contentType: TEXT
    CreateICCPAuthorizationSubscription:
      value:
        name: TestSubscription_ICCPPaymentAuthorization
        subjectType: PAYMENT_AUTHORIZATION
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children:
          - type: FIELD
            operator: AND
            fieldMappingName: virtualPaymentCard.number
            fieldOperator: EQUALS
            expectedContent:
              value: '1234567890123456'
              contentType: TEXT
            children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: BOC
            contentType: TEXT
    UpdateBPCAuthorizationSubscription:
      value:
        name: TestSubscription_BPCPaymentAuthorization_Updated
        subjectType: BPC_PAYMENT_AUTHORIZATION
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: messageTypeIndicator
          fieldOperator: EQUALS
          expectedContent:
            value: '12312'
            contentType: TEXT
    BPSPaymentUpdateSubscriptionResponse:
      value:
        id: 0CNSee76a6d031ba2166fe83ed7203f74b52134758270d1339c995b3be6c68a918211718964283
        name: TestSubscription_ICCPPaymentUpdate
        subjectType: PAYMENT_UPDATE
        subscriberId: C94BC2953D52DCE1E05368459E0ADF8E
        active: true
        specifications: []
    BPSPaymentUpdateUpdatedSubscriptionResponse:
      value:
        id: 0CNSee76a6d031ba2166fe83ed7203f74b52134758270d1339c995b3be6c68a918211718964283
        name: TestSubscription_PaymentUpdateUpdated
        subjectType: PAYMENT_UPDATE
        subscriberId: C94BC2953D52DCE1E05368459E0ADF8E
        active: true
        specifications: []
    BPCAuthorizationUpdatedSubscriptionResponse:
      value:
        id: 0CNS5f3aee95730c70a70ca85cb66f13ac40eeb79c6bc508cbe58e1c74ae97f18bb01718868027
        name: TestSubscription_BPCAuthUpdated
        subjectType: BPC_PAYMENT_AUTHORIZATION
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS12fe24ddd5529bbfb317894e15b946ed3e5878b2382163ae9534b1cf38a3875a1718952480
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1360ACE9C4D4CBFEE06368459E0ADD50
            name: messageTypeIndicator
            displayName: MessageTypeIndicator
            subjectType: BPC_PAYMENT_AUTHORIZATION
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: '12312'
            contentType: TEXT
    ICMPProvisioningUpdatedSubscriptionResponse:
      value:
        id: 0CNSa56c4e01133b472a532678ab1e02b394de1886b3692eb42c99287ef10cffa59c1720083461
        name: TestSubscription_ICMPTokenProvisioningUpdated
        subjectType: TOKEN_PROVISIONING_EVENT
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS63299c1c2fcd133327b88e12457b67333543ba4be3c1f77880b3fb99e25e31421720087279
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1AD42C3FCAF12726E06368459E0A9487
            name: purchaseRequest.rcnAlias
            displayName: Purchase Request RCN Alias
            subjectType: TOKEN_PROVISIONING_EVENT
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    ICCPAuthorizationUpdatedSubscriptionResponse:
      value:
        id: 0CNSf829c8c968765f86f51418c28d6b0430daa657174c3920a474890e540be5495d1718867617
        name: TestSubscription_ICCPAuthUpdated
        subjectType: PAYMENT_AUTHORIZATION
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS9e4f526d9641a7e65247f832e6f98505330cfcdd2e1955fabaa711ad052160971718952594
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 0CNSa6d4a329d377bb296957df43e9f2f1ab5b35c997f88bcbc34939bc1525990be51556724071
            name: messageTypeIndicator
            displayName: Message type indicator
            subjectType: PAYMENT_AUTHORIZATION
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: '12312'
            contentType: TEXT
    ICCPClearingSubscriptionResponse:
      value:
        id: 0CNS0aa3f4e102b6f00976f9556d9af9951951ca3218f5d64d80c91b9057cdcff0a21718868785
        name: TestSubscription_ICCPClearing
        subjectType: CLEARING
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS4ab8577afb3a04ffa75e1ae75beb4509ac850d259b322b3b8dc3c721ec56777d1718868785
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 135E59332C54BF9AE06368459E0ACEF0
            name: purchaseRequest.rcnAlias
            displayName: purchaseRequest rcnAlias
            subjectType: CLEARING
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: test rcn alias
            contentType: TEXT
    ICMPLifecycleSubscriptionResponse:
      value:
        id: 0CNSa56c4e01133b472a532678ab1e02b394de1886b3692eb42c99287ef10cffa59c1720083461
        name: TestSubscription_ICMPTokenLifecycle
        subjectType: TOKEN_LIFECYCLE_EVENT
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNSb12ce4d40ae45a3ff9cb9928f66ded61345e1cd45fc8d4991a0ce200d2b11ee11720083461
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 1AD42C3FCAF12726E06368459E0A9487
            name: purchaseRequest.rcnAlias
            displayName: Purchase Request RCN Alias
            subjectType: TOKEN_LIFECYCLE_EVENT
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    UpdateICCPAuthorizationSubscription:
      value:
        name: TestSubscription_ICCPPaymentAuthorization_Updated
        subjectType: PAYMENT_AUTHORIZATION
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children:
          - type: FIELD
            operator: AND
            fieldMappingName: purchaseRequest.rcnAlias
            fieldOperator: EQUALS
            expectedContent:
              value: Travel Expense RCN
              contentType: TEXT
            children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: BOC
            contentType: TEXT
    CreateICMPProvisioningSubscription:
      value:
        name: TestSubscription_ICMPTokenProvisioning
        subjectType: TOKEN_PROVISIONING_EVENT
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    GetSubscriptionBPSResponse:
      value:
      - id: ABSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724070
        name: TestSubscription_PaymentUpdate
        subjectType: PAYMENT_UPDATE
        subscriberId: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724071
        active: true
        specifications: []
    ICCPClearingUpdatedSubscriptionResponse:
      value:
        id: 0CNS0aa3f4e102b6f00976f9556d9af9951951ca3218f5d64d80c91b9057cdcff0a21718868785
        name: TestSubscription_ICCPClearingUpdated
        subjectType: CLEARING
        subscriberId: A49875790BBF5F19E0535B449E0A5014
        active: true
        specifications:
        - id: 0CNS91d2a2d3c9a517aee50830da16e83ed675262ca013fb9f82119867ccf4c5c1231718952258
          type: FIELD
          operator: WHERE
          children: []
          fieldMapping:
            id: 135E59332C54BF9AE06368459E0ACEF0
            name: purchaseRequest.rcnAlias
            displayName: purchaseRequest rcnAlias
            subjectType: CLEARING
            contentType: TEXT
          fieldOperator: EQUALS
          expectedContent:
            value: test rcn alias
            contentType: TEXT
    UpdateICMPProvisioningSubscription:
      value:
        name: TestSubscription_ICMPTokenProvisioningUpdated
        subjectType: TOKEN_PROVISIONING_EVENT
        active: true
        specifications:
        - type: FIELD
          operator: WHERE
          children: []
          fieldMappingName: purchaseRequest.rcnAlias
          fieldOperator: EQUALS
          expectedContent:
            value: TEXT
            contentType: TEXT
    UpdateBPSPaymentUpdateSubscription:
      value:
        name: TestSubscription_ICCPPaymentUpdate_Updated
        subjectType: PAYMENT_UPDATE
        active: true
        specifications: []
  schemas:
    BaseAccount:
      description: Properties common to all accounts
      type: object
      required:
      - accountNumber
      - expiryDate
      properties:
        accountNumber:
          $ref: '#/components/schemas/AccountNumber'
        expiryDate:
          $ref: '#/components/schemas/Expiry'
    AccountUpdate:
      type: object
      properties:
        account:
          $ref: '#/components/schemas/Account'
        responseIndicator:
          $ref: '#/components/schemas/ResponseIndicator'
    MerchantId:
      type: string
      maxLength: 15
      minLength: 15
      example: '000000000002535'
      description: A merchant ID or payment facilitator ID, previously registered with Mastercard.
    AccountNumber:
      type: string
      maxLength: 19
      minLength: 13
      example: '5573491171027315'
      description: The account number being inquired upon.
    ErrorWrapper:
      type: object
      required:
      - Errors
      properties:
        Errors:
          $ref: '#/components/schemas/Errors'
    Error:
      type: object
      properties:
        Source:
          type: string
          example: Validation
          description: The application name that generated this error. Every error message that is generated and returned by the gateway will have this field equal to Gateway.
          maxLength: 100
          minLength: 1
        ReasonCode:
          type: string
          example: ICA_VALUE_REQUIRED
          description: A unique constant identifying the error case encountered during request processing.
          maxLength: 100
          minLength: 1
        Description:
          type: string
          example: ICA required for ABU client eligibility validation
          description: Short description of the ReasonCode field.
          maxLength: 1000
          minLength: 10
        Recoverable:
          type: boolean
          example: false
          description: Indicates whether this error will always be returned for this request, or retrying could change the outcome.
        Details:
          type: string
          description: (Optional) Where appropriate, indicates detailed information about data received and calculated during request processing, to help the customer with diagnosing errors.
          example: ICA is Mandatory
          maxLength: 5000
          minLength: 0
    Errors:
      type: object
      required:
      - Error
      properties:
        Error:
          $ref: '#/components/schemas/ErrorList'
    ErrorList:
      type: array
      minItems: 1
      items:
        $ref: '#/components/schemas/Error'
    Expiry:
      type: string
      maxLength: 4
      minLength: 4
      example: '1228'
      description: The expiration date associated to the account number being inquired upon. Must be in MMYY format.
    Ica:
      type: string
      minLength: 4
      maxLength: 15
      example: '1111'
      description: A number assigned by Mastercard to a licensed customer to identify the member in transactions. This is used as an identifier for data submitted to ABU.
    Customer:
      description: Representation of a customer
      type: object
      allOf:
      - $ref: '#/components/schemas/BaseCustomer'
      - type: object
        properties:
          subMerchantId:
            $ref: '#/components/schemas/SubMerchantId'
    ResponseIndicator:
      type: string
      pattern: ^(VALID|UNKNOWN|NON_PARTICIPATING|CONTACT|EXPIRY|ACCOUNT_UPDATE)
      example: VALID
      description: 'An indicator to help explain the status of the account being inquired on. Possible values are:

        * `VALID` = Matches the account as reported by the issuer.

        * `UNKNOWN` = Account number is not known to ABU or part of a participating BIN (Bank Identification Number) and/or issuer.

        * `NON_PARTICIPATING` = Account number is not known to ABU or part of a non-participating BIN (Bank Identification Number) and/or issuer.

        * `CONTACT` (C) = Contact the issuer.

        * `EXPIRY` (E) = The card inquired on is expired, updated expiry date returned.

        * `ACCOUNT_UPDATE` (A) = The card inquired on is updated, updated card number and expiry date returned.'
    Account:
      description: Representation of an account
      type: object
      allOf:
      - $ref: '#/components/schemas/BaseAccount'
      - type: object
    BaseCustomer:
      description: Properties common to all customer
      type: object
      required:
      - ica
      - merchantId
      properties:
        ica:
          $ref: '#/components/schemas/Ica'
        merchantId:
          $ref: '#/components/schemas/MerchantId'
    SubMerchantId:
      type: string
      maxLength: 15
      minLength: 15
      example: '000000000000001'
      description: An optional identifier for a sub-merchant of a payment facilitators under a registered merchant ID.
    CustomerAccount:
      type: object
      required:
      - requestId
      - customer
      - account
      properties:
        requestId:
          type: string
          maxLength: 64
          minLength: 1
          example: 323e304f-1cfc-4f0d-ac07-e6037ce09925
          description: An identifier established by the customer.
        customer:
          $ref: '#/components/schemas/Customer'
        account:
          $ref: '#/components/schemas/Account'
    Subscription:
      allOf:
      - $ref: '#/components/schemas/CustomerAccount'
      - type: object
    OutSubscription:
      allOf:
      - $ref: '#/components/schemas/AccountUpdate'
      - type: object
    SpecificationDetails:
      description: Specifies criteria to determine whether an event should cause a notification to be generated.
      type: object
      properties:
        id:
          description: Specification id, auto-generated by the system and read-only for the client
          type: string
          minLength: 1
          maxLength: 255
          readOnly: true
          example: CNSa91bf379b48a593fd17f07f431bad8fb296796498f4e9982ea134394c1fa4f071556724072
        type:
          description: The type of item to which the criteria refers. Currently the type 'FIELD' is allowed, which refers to matching a field in the notification itself
          type: string
          minLength: 1
          maxLength: 255
          default: FIELD
          example: FIELD
        operator:
          description: The operator that defines how this specification (criteria) logically relates to other specifications in the list. The first specification in the list will have an operator of 'WHERE' and subsequent specifications will have an 'AND' or 'OR' relationship with their preceding specification
          type: string
          minLength: 1
          maxLength: 255
          default: WHERE
          example: WHERE
        fieldMapping:
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/FieldMapping'
        fieldOperator:
          description: The check operation that is to be performed. Currently one of allowed values are 'EQUALS', 'GREATER_THAN', 'LESS_THAN', 'BETWE

# --- truncated at 32 KB (140 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mastercard/refs/heads/main/openapi/mastercard-subscriptions-api-openapi.yml

Mastercard Subscriptions API

Operations 5

Documentation

Specifications

Code Examples

Other Resources