Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zuora Custom Payment Method Types API

Open Payment Method (OPM) service is a framework developed by Zuora, which allows you to integrate your custom payment method to Zuora subscription, billing, and revenue management in a dynamic and flexible manner. With the support of the OPM service, you are able to define your custom payment method types and create custom payment methods of the defined types. The custom payment method of the defined type can only be used with the custom payment gateway that you set up through the Universal Payment Connector (UPC) service. It cannot be used with the Zuora out-of-box gateway integrations such as GoCardless, Stripe, etc.You can define up to 20 custom payment method types for one tenant. Do not define your fields with the [Zuora-reserved fields](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/MB_Set_up_custom_payment_gateways_and_payment_methods/C_Configure_and_manage_your_custom_payment_method_types_through_Zuora_REST_APIs#Zuora-reserved_fields).See [Set up custom payment gateways and payment methods](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/MB_Set_up_custom_payment_gateways_and_payment_methods) for more information about the OPM and UPC services.Note: You can only use the bearer token to access the "Custom Payment Method Types" API operations. Access with `apiAccessKeyId` and `apiSecretAccessKey` is not supported.

Zuora Custom Payment Method Types API is one of 80 APIs that Zuora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Custom Payment Method Types. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 5 paths, and defines 8 schemas. It is described by OpenAPI 2.0, at version 2023-12-15.

5 operations 5 paths 8 schemas 2 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2023-12-15
Resource Areas
1

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 2 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Custom Payment Method Types 5

Open Payment Method (OPM) service is a framework developed by Zuora, which allows you to integrate your custom payment method to Zuora subscription, billing, and revenue managemen…

POST
/open-payment-method-types
Create a draft custom payment method type
POST_CreateDraftOpenPaymentMethodType 8 params → 200
PUT
/open-payment-method-types/publish/{paymentMethodTypeName}
Publish a custom payment method type
PUT_PublishOpenPaymentMethodType 7 params → 200
PUT
/open-payment-method-types/{paymentMethodTypeName}
Update a custom payment method type
PUT_UpdateOpenPaymentMethodType 8 params → 200
GET
/open-payment-method-types/{paymentMethodTypeName}/draft/{revisionNumber}
Retrieve a specific draft revision of a custom payment method type
GET_OpenPaymentMethodTypeRevision 8 params → 200
GET
/open-payment-method-types/{paymentMethodTypeName}/published
Retrieve a published custom payment method type
GET_OpenPaymentMethodTypePublish 7 params → 200

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are OpenPaymentMethodTypeRequestFields (13 properties), OpenPaymentMethodTypeResponseFields (13 properties), GETOpenPaymentMethodTypeRevisionResponse (11 properties), PUTPublishOpenPaymentMethodTypeResponse (11 properties). Each schema is shown below with its type and property counts.

POSTCreateOpenPaymentMethodTypeResponse
object
4 properties
POSTCreateOpenPaymentMethodTypeRequest
object
8 properties 5 required
OpenPaymentMethodTypeResponseFields
object
13 properties
OpenPaymentMethodTypeRequestFields
object
13 properties
PUTUpdateOpenPaymentMethodTypeResponse
object
4 properties
PUTUpdateOpenPaymentMethodTypeRequest
object
8 properties 5 required
GETOpenPaymentMethodTypeRevisionResponse
object
11 properties
PUTPublishOpenPaymentMethodTypeResponse
object
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zuora-custom-payment-method-types-api-openapi.yml Raw ↑

Other APIs Zuora publishes across the network.

Zuora V1 API
Zuora Accounting Codes API
Zuora Accounting Periods API
Zuora Accounts API
Zuora Actions API
Zuora Aggregate Queries API
Zuora API Health API
Zuora Attachments API
Zuora Bill Run API
Zuora Bill Run Health API
Zuora Billing Documents API
Zuora Billing Preview Run API