From 0c0c4a5268232c0f19ac5b3a5dafc6a85753651e Mon Sep 17 00:00:00 2001 From: Reshma Bidikar <85998496+reshmabidikar@users.noreply.github.com> Date: Mon, 20 Apr 2026 10:13:57 +0530 Subject: [PATCH] Add requestedDate query parameter to createCredit API --- .idea/misc.xml | 3 +- .swagger-codegen/KB_VERSION | 6 +- .swagger-codegen/kbswagger.yaml | 10581 ++++++++-------- pom.xml | 4 +- .../billing/client/api/gen/CreditApi.java | 10 +- .../client/model/gen/EventSubscription.java | 17 +- 6 files changed, 5316 insertions(+), 5305 deletions(-) diff --git a/.idea/misc.xml b/.idea/misc.xml index 1c3f3fd..e6ab90e 100644 --- a/.idea/misc.xml +++ b/.idea/misc.xml @@ -1,5 +1,6 @@ + @@ -10,5 +11,5 @@ - + \ No newline at end of file diff --git a/.swagger-codegen/KB_VERSION b/.swagger-codegen/KB_VERSION index d83dabc..b9f9e3c 100644 --- a/.swagger-codegen/KB_VERSION +++ b/.swagger-codegen/KB_VERSION @@ -1,4 +1,4 @@ swaggerVersion=2.4.1 -kbVersion=0.23.0-SNAPSHOT -kbApiVersion=0.54.0-ded8ade-SNAPSHOT -kbPluginApiVersion=0.27.0-df83159-SNAPSHOT +kbVersion=0.24.17-SNAPSHOT +kbApiVersion=0.54.0 +kbPluginApiVersion=0.27.3 diff --git a/.swagger-codegen/kbswagger.yaml b/.swagger-codegen/kbswagger.yaml index a9b14be..3e6ea09 100644 --- a/.swagger-codegen/kbswagger.yaml +++ b/.swagger-codegen/kbswagger.yaml @@ -2,7 +2,7 @@ swagger: "2.0" info: description: "Kill Bill is an open-source billing and payments platform" - version: "0.23.0-SNAPSHOT" + version: "0.24.17-SNAPSHOT" title: "Kill Bill" contact: name: "killbilling-users@googlegroups.com" @@ -34,13 +34,13 @@ tags: - name: "PaymentTransaction" - name: "Usage" paths: - /1.0/kb/accounts/{accountId}/tags: + /1.0/kb/accounts/{accountId}/children: get: tags: - "Account" - summary: "Retrieve account tags" + summary: "List children accounts" description: "" - operationId: "getAccountTags" + operationId: "getChildrenAccounts" produces: - "application/json" parameters: @@ -50,7 +50,12 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "includedDeleted" + - name: "accountWithBalance" + in: "query" + required: false + type: "boolean" + default: false + - name: "accountWithBalanceAndCBA" in: "query" required: false type: "boolean" @@ -70,108 +75,11 @@ paths: schema: type: "array" items: - $ref: "#/definitions/Tag" + $ref: "#/definitions/Account" "400": - description: "Invalid account id supplied" + description: "Invalid parent account id supplied" "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - post: - tags: - - "Account" - summary: "Add tags to account" - description: "" - operationId: "createAccountTags" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - type: "string" - format: "uuid" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "201": - description: "Tag created successfully" - schema: - type: "array" - items: - $ref: "#/definitions/Tag" - "400": - description: "Invalid account id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: - tags: - - "Account" - summary: "Remove tags from account" - description: "" - operationId: "deleteAccountTags" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "tagDef" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid account id supplied or account does not have a default\ - \ payment method (AUTO_PAY_OFF tag only)" + description: "Parent Account not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -489,47 +397,6 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/emails/{email}: - delete: - tags: - - "Account" - summary: "Delete email from account" - description: "" - operationId: "removeEmail" - produces: - - "application/json" - parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "email" - in: "path" - required: true - type: "string" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid account id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] /1.0/kb/accounts/search/{searchKey}: get: tags: @@ -639,13 +506,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/invoicePayments: - get: + /1.0/kb/accounts/{accountId}/emails/{email}: + delete: tags: - "Account" - summary: "Retrieve account invoice payments" + summary: "Delete email from account" description: "" - operationId: "getInvoicePayments" + operationId: "removeEmail" produces: - "application/json" parameters: @@ -655,23 +522,52 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "withPluginInfo" - in: "query" + - name: "email" + in: "path" + required: true + type: "string" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" required: false - type: "boolean" - default: false - - name: "withAttempts" + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid account id supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/accounts/{accountId}/tags: + get: + tags: + - "Account" + summary: "Retrieve account tags" + description: "" + operationId: "getAccountTags" + produces: + - "application/json" + parameters: + - name: "accountId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "includedDeleted" in: "query" required: false type: "boolean" default: false - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - name: "audit" in: "query" required: false @@ -687,7 +583,7 @@ paths: schema: type: "array" items: - $ref: "#/definitions/InvoicePayment" + $ref: "#/definitions/Tag" "400": description: "Invalid account id supplied" "404": @@ -699,9 +595,9 @@ paths: post: tags: - "Account" - summary: "Trigger a payment for all unpaid invoices" + summary: "Add tags to account" description: "" - operationId: "payAllInvoices" + operationId: "createAccountTags" consumes: - "application/json" produces: @@ -713,31 +609,63 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "paymentMethodId" - in: "query" - required: false + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + type: "string" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true type: "string" - format: "uuid" - - name: "externalPayment" - in: "query" - required: false - type: "boolean" - default: false - - name: "paymentAmount" - in: "query" + - name: "X-Killbill-Reason" + in: "header" required: false - type: "number" - - name: "targetDate" - in: "query" + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - format: "date" - - name: "pluginProperty" + responses: + "201": + description: "Tag created successfully" + schema: + type: "array" + items: + $ref: "#/definitions/Tag" + "400": + description: "Invalid account id supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + delete: + tags: + - "Account" + summary: "Remove tags from account" + description: "" + operationId: "deleteAccountTags" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "accountId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "tagDef" in: "query" required: false type: "array" items: type: "string" + format: "uuid" collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" @@ -752,27 +680,22 @@ paths: required: false type: "string" responses: - "201": - description: "Successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Invoice" "204": - description: "Nothing to pay" - "404": - description: "Invalid account id supplied" + description: "Successful operation" + "400": + description: "Invalid account id supplied or account does not have a default\ + \ payment method (AUTO_PAY_OFF tag only)" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/customFields: + /1.0/kb/accounts/{accountId}/bundles: get: tags: - "Account" - summary: "Retrieve account custom fields" + summary: "Retrieve bundles for account" description: "" - operationId: "getAccountCustomFields" + operationId: "getAccountBundles" produces: - "application/json" parameters: @@ -782,6 +705,14 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "externalKey" + in: "query" + required: false + type: "string" + - name: "bundlesFilter" + in: "query" + required: false + type: "string" - name: "audit" in: "query" required: false @@ -797,21 +728,22 @@ paths: schema: type: "array" items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/Bundle" "400": description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + /1.0/kb/accounts/{accountId}/timeline: + get: tags: - "Account" - summary: "Add custom fields to account" + summary: "Retrieve account timeline" description: "" - operationId: "createAccountCustomFields" - consumes: - - "application/json" + operationId: "getAccountTimeline" produces: - "application/json" parameters: @@ -821,46 +753,40 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + - name: "parallel" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "boolean" + default: false + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "201": - description: "Custom field created successfully" + "200": + description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/AccountTimeline" "400": description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - put: + /1.0/kb/accounts/{accountId}/allCustomFields: + get: tags: - "Account" - summary: "Modify custom fields to account" + summary: "Retrieve account customFields" description: "" - operationId: "modifyAccountCustomFields" - consumes: - - "application/json" + operationId: "getAllCustomFields" produces: - "application/json" parameters: @@ -870,42 +796,61 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + - name: "objectType" + in: "query" required: false type: "string" - - name: "X-Killbill-Comment" - in: "header" + enum: + - "ACCOUNT" + - "ACCOUNT_EMAIL" + - "BLOCKING_STATES" + - "BUNDLE" + - "CUSTOM_FIELD" + - "INVOICE" + - "PAYMENT" + - "TRANSACTION" + - "INVOICE_ITEM" + - "INVOICE_PAYMENT" + - "SUBSCRIPTION" + - "SUBSCRIPTION_EVENT" + - "SERVICE_BROADCAST" + - "PAYMENT_ATTEMPT" + - "PAYMENT_METHOD" + - "TAG" + - "TAG_DEFINITION" + - "TENANT" + - "TENANT_KVS" + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" "400": description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + /1.0/kb/accounts/{accountId}/allTags: + get: tags: - "Account" - summary: "Remove custom fields from account" + summary: "Retrieve account tags" description: "" - operationId: "deleteAccountCustomFields" - consumes: - - "application/json" + operationId: "getAllTags" produces: - "application/json" parameters: @@ -915,42 +860,66 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "customField" + - name: "objectType" in: "query" required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true type: "string" - - name: "X-Killbill-Reason" - in: "header" + enum: + - "ACCOUNT" + - "ACCOUNT_EMAIL" + - "BLOCKING_STATES" + - "BUNDLE" + - "CUSTOM_FIELD" + - "INVOICE" + - "PAYMENT" + - "TRANSACTION" + - "INVOICE_ITEM" + - "INVOICE_PAYMENT" + - "SUBSCRIPTION" + - "SUBSCRIPTION_EVENT" + - "SERVICE_BROADCAST" + - "PAYMENT_ATTEMPT" + - "PAYMENT_METHOD" + - "TAG" + - "TAG_DEFINITION" + - "TENANT" + - "TENANT_KVS" + - name: "includedDeleted" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "boolean" + default: false + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/Tag" "400": description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/block: + /1.0/kb/accounts/{accountId}/overdue: get: tags: - "Account" - summary: "Retrieve blocking states for account" + summary: "Retrieve overdue state for account" description: "" - operationId: "getBlockingStates" + operationId: "getOverdueAccount" produces: - "application/json" parameters: @@ -960,19 +929,47 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "blockingStateTypes" - in: "query" - required: false - type: "array" - items: - type: "string" - enum: - - "SUBSCRIPTION" - - "SUBSCRIPTION_BUNDLE" - - "ACCOUNT" - collectionFormat: "multi" - - name: "blockingStateSvcs" - in: "query" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/OverdueState" + "400": + description: "Invalid account id supplied" + "404": + description: "Account not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/accounts/{accountId}/invoicePayments: + get: + tags: + - "Account" + summary: "Retrieve account invoice payments" + description: "" + operationId: "getInvoicePayments" + produces: + - "application/json" + parameters: + - name: "accountId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "withPluginInfo" + in: "query" + required: false + type: "boolean" + default: false + - name: "withAttempts" + in: "query" + required: false + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" required: false type: "array" items: @@ -993,9 +990,11 @@ paths: schema: type: "array" items: - $ref: "#/definitions/BlockingState" + $ref: "#/definitions/InvoicePayment" "400": description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -1003,11 +1002,13 @@ paths: post: tags: - "Account" - summary: "Block an account" + summary: "Trigger a payment for all unpaid invoices" description: "" - operationId: "addAccountBlockingState" + operationId: "payAllInvoices" consumes: - "application/json" + produces: + - "application/json" parameters: - name: "accountId" in: "path" @@ -1015,12 +1016,21 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/BlockingState" - - name: "requestedDate" + - name: "paymentMethodId" + in: "query" + required: false + type: "string" + format: "uuid" + - name: "externalPayment" + in: "query" + required: false + type: "boolean" + default: false + - name: "paymentAmount" + in: "query" + required: false + type: "number" + - name: "targetDate" in: "query" required: false type: "string" @@ -1046,55 +1056,26 @@ paths: type: "string" responses: "201": - description: "Blocking state created successfully" - schema: - type: "array" - items: - $ref: "#/definitions/BlockingState" - "400": - description: "Invalid account id supplied" - "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/auditLogs: - get: - tags: - - "Account" - summary: "Retrieve audit logs by account id" - description: "" - operationId: "getAccountAuditLogs" - produces: - - "application/json" - parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - responses: - "200": - description: "successful operation" + description: "Successful operation" schema: type: "array" items: - $ref: "#/definitions/AuditLog" + $ref: "#/definitions/Invoice" + "204": + description: "Nothing to pay" "404": - description: "Account not found" + description: "Invalid account id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/children: + /1.0/kb/accounts/{accountId}/payments: get: tags: - "Account" - summary: "List children accounts" + summary: "Retrieve account payments" description: "" - operationId: "getChildrenAccounts" + operationId: "getPaymentsForAccount" produces: - "application/json" parameters: @@ -1104,16 +1085,23 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "accountWithBalance" + - name: "withAttempts" in: "query" required: false type: "boolean" default: false - - name: "accountWithBalanceAndCBA" + - name: "withPluginInfo" in: "query" required: false type: "boolean" default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "audit" in: "query" required: false @@ -1129,33 +1117,54 @@ paths: schema: type: "array" items: - $ref: "#/definitions/Account" + $ref: "#/definitions/Payment" "400": - description: "Invalid parent account id supplied" - "404": - description: "Parent Account not found" + description: "Invalid account id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{childAccountId}/transferCredit: - put: + post: tags: - "Account" - summary: "Move a given child credit to the parent level" + summary: "Trigger a payment (authorization, purchase or credit)" description: "" - operationId: "transferChildCreditToParent" + operationId: "processPayment" consumes: - "application/json" produces: - "application/json" parameters: - - name: "childAccountId" + - name: "accountId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/PaymentTransaction" + - name: "paymentMethodId" + in: "query" + required: false + type: "string" + format: "uuid" + - name: "controlPluginName" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -1169,23 +1178,35 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Payment transaction created successfully" + schema: + $ref: "#/definitions/Payment" "400": - description: "Account does not have credit" + description: "Invalid account id supplied" "404": description: "Account not found" + "402": + description: "Transaction declined by gateway" + "422": + description: "Payment is aborted by a control plugin" + "502": + description: "Failed to submit payment transaction" + "503": + description: "Payment in unknown status, failed to receive gateway response" + "504": + description: "Payment operation timeout" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/paymentMethods/refresh: - put: + /1.0/kb/accounts/{accountId}/paymentMethods: + get: tags: - "Account" - summary: "Refresh account payment methods" + summary: "Retrieve account payment methods" description: "" - operationId: "refreshPaymentMethods" + operationId: "getPaymentMethodsForAccount" produces: - "application/json" parameters: @@ -1195,10 +1216,16 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "pluginName" + - name: "withPluginInfo" in: "query" required: false - type: "string" + type: "boolean" + default: false + - name: "includedDeleted" + in: "query" + required: false + type: "boolean" + default: false - name: "pluginProperty" in: "query" required: false @@ -1206,21 +1233,22 @@ paths: items: type: "string" collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/PaymentMethod" "400": description: "Invalid account id supplied" "404": @@ -1229,13 +1257,12 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/paymentMethods/{paymentMethodId}/setDefault: - put: + post: tags: - "Account" - summary: "Set the default payment method" + summary: "Add a payment method" description: "" - operationId: "setDefaultPaymentMethod" + operationId: "createPaymentMethod" consumes: - "application/json" produces: @@ -1247,17 +1274,28 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "paymentMethodId" - in: "path" + - in: "body" + name: "body" required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + schema: + $ref: "#/definitions/PaymentMethod" + - name: "isDefault" + in: "query" + required: false + type: "boolean" + default: false - name: "payAllUnpaidInvoices" in: "query" required: false type: "boolean" default: false + - name: "controlPluginName" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "pluginProperty" in: "query" required: false @@ -1278,52 +1316,64 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Payment method created" + schema: + $ref: "#/definitions/PaymentMethod" "400": - description: "Invalid account id or payment method id supplied" + description: "Invalid account id supplied" "404": description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/block/{blockingId}/auditLogsWithHistory: + /1.0/kb/accounts/{accountId}/customFields: get: tags: - "Account" - summary: "Retrieve blocking state audit logs with history by id" + summary: "Retrieve account custom fields" description: "" - operationId: "getBlockingStateAuditLogsWithHistory" + operationId: "getAccountCustomFields" produces: - "application/json" parameters: - - name: "blockingId" + - name: "accountId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/AuditLog" - "404": - description: "Blocking state not found" + $ref: "#/definitions/CustomField" + "400": + description: "Invalid account id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/emails/{accountEmailId}/auditLogsWithHistory: - get: + post: tags: - "Account" - summary: "Retrieve account email audit logs with history by id" + summary: "Add custom fields to account" description: "" - operationId: "getAccountEmailAuditLogsWithHistory" + operationId: "createAccountCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: @@ -1333,32 +1383,46 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "accountEmailId" - in: "path" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" + - name: "X-Killbill-CreatedBy" + in: "header" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" responses: - "200": - description: "successful operation" + "201": + description: "Custom field created successfully" schema: type: "array" items: - $ref: "#/definitions/AuditLog" - "404": - description: "Account not found" + $ref: "#/definitions/CustomField" + "400": + description: "Invalid account id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/paymentMethods: - get: + put: tags: - "Account" - summary: "Retrieve account payment methods" + summary: "Modify custom fields to account" description: "" - operationId: "getPaymentMethodsForAccount" + operationId: "modifyAccountCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: @@ -1368,53 +1432,40 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "includedDeleted" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginProperty" - in: "query" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "audit" - in: "query" + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/PaymentMethod" + "204": + description: "Successful operation" "400": description: "Invalid account id supplied" - "404": - description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + delete: tags: - "Account" - summary: "Add a payment method" + summary: "Remove custom fields from account" description: "" - operationId: "createPaymentMethod" + operationId: "deleteAccountCustomFields" consumes: - "application/json" produces: @@ -1426,34 +1477,13 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/PaymentMethod" - - name: "isDefault" - in: "query" - required: false - type: "boolean" - default: false - - name: "payAllUnpaidInvoices" - in: "query" - required: false - type: "boolean" - default: false - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "pluginProperty" + - name: "customField" in: "query" required: false type: "array" items: type: "string" + format: "uuid" collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" @@ -1468,14 +1498,10 @@ paths: required: false type: "string" responses: - "201": - description: "Payment method created" - schema: - $ref: "#/definitions/PaymentMethod" + "204": + description: "Successful operation" "400": description: "Invalid account id supplied" - "404": - description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -1556,80 +1582,6 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/invoices: - get: - tags: - - "Account" - summary: "Retrieve account invoices" - description: "" - operationId: "getInvoicesForAccount" - produces: - - "application/json" - parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "startDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "endDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "withMigrationInvoices" - in: "query" - required: false - type: "boolean" - default: false - - name: "unpaidInvoicesOnly" - in: "query" - required: false - type: "boolean" - default: false - - name: "includeVoidedInvoices" - in: "query" - required: false - type: "boolean" - default: false - - name: "includeInvoiceComponents" - in: "query" - required: false - type: "boolean" - default: false - - name: "invoicesFilter" - in: "query" - required: false - type: "string" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Invoice" - "400": - description: "Invalid account id supplied" - "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] /1.0/kb/accounts/{accountId}/cbaRebalancing: put: tags: @@ -1750,13 +1702,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/bundles/pagination: + /1.0/kb/accounts/{accountId}/block: get: tags: - "Account" - summary: "Retrieve paginated bundles for account" + summary: "Retrieve blocking states for account" description: "" - operationId: "getAccountBundlesPaginated" + operationId: "getBlockingStates" produces: - "application/json" parameters: @@ -1766,69 +1718,18 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" + - name: "blockingStateTypes" in: "query" required: false - type: "integer" - default: 100 - format: "int64" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Bundle" - "400": - description: "Invalid account id supplied" - "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/payments: - get: - tags: - - "Account" - summary: "Retrieve account payments" - description: "" - operationId: "getPaymentsForAccount" - produces: - - "application/json" - parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "withAttempts" - in: "query" - required: false - type: "boolean" - default: false - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginProperty" + type: "array" + items: + type: "string" + enum: + - "SUBSCRIPTION" + - "SUBSCRIPTION_BUNDLE" + - "ACCOUNT" + collectionFormat: "multi" + - name: "blockingStateSvcs" in: "query" required: false type: "array" @@ -1850,7 +1751,7 @@ paths: schema: type: "array" items: - $ref: "#/definitions/Payment" + $ref: "#/definitions/BlockingState" "400": description: "Invalid account id supplied" security: @@ -1860,13 +1761,11 @@ paths: post: tags: - "Account" - summary: "Trigger a payment (authorization, purchase or credit)" + summary: "Block an account" description: "" - operationId: "processPayment" + operationId: "addAccountBlockingState" consumes: - "application/json" - produces: - - "application/json" parameters: - name: "accountId" in: "path" @@ -1878,19 +1777,12 @@ paths: name: "body" required: true schema: - $ref: "#/definitions/PaymentTransaction" - - name: "paymentMethodId" + $ref: "#/definitions/BlockingState" + - name: "requestedDate" in: "query" required: false type: "string" - format: "uuid" - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" + format: "date" - name: "pluginProperty" in: "query" required: false @@ -1912,34 +1804,26 @@ paths: type: "string" responses: "201": - description: "Payment transaction created successfully" + description: "Blocking state created successfully" schema: - $ref: "#/definitions/Payment" + type: "array" + items: + $ref: "#/definitions/BlockingState" "400": description: "Invalid account id supplied" "404": description: "Account not found" - "402": - description: "Transaction declined by gateway" - "422": - description: "Payment is aborted by a control plugin" - "502": - description: "Failed to submit payment transaction" - "503": - description: "Payment in unknown status, failed to receive gateway response" - "504": - description: "Payment operation timeout" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/allCustomFields: + /1.0/kb/accounts/{accountId}/bundles/pagination: get: tags: - "Account" - summary: "Retrieve account customFields" + summary: "Retrieve paginated bundles for account" description: "" - operationId: "getAllCustomFields" + operationId: "getAccountBundlesPaginated" produces: - "application/json" parameters: @@ -1949,30 +1833,18 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "objectType" + - name: "offset" in: "query" required: false - type: "string" - enum: - - "ACCOUNT" - - "ACCOUNT_EMAIL" - - "BLOCKING_STATES" - - "BUNDLE" - - "CUSTOM_FIELD" - - "INVOICE" - - "PAYMENT" - - "TRANSACTION" - - "INVOICE_ITEM" - - "INVOICE_PAYMENT" - - "SUBSCRIPTION" - - "SUBSCRIPTION_EVENT" - - "SERVICE_BROADCAST" - - "PAYMENT_ATTEMPT" - - "PAYMENT_METHOD" - - "TAG" - - "TAG_DEFINITION" - - "TENANT" - - "TENANT_KVS" + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" - name: "audit" in: "query" required: false @@ -1988,7 +1860,7 @@ paths: schema: type: "array" items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/Bundle" "400": description: "Invalid account id supplied" "404": @@ -1997,13 +1869,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/bundles: + /1.0/kb/accounts/{accountId}/invoices: get: tags: - "Account" - summary: "Retrieve bundles for account" + summary: "Retrieve account invoices" description: "" - operationId: "getAccountBundles" + operationId: "getInvoicesForAccount" produces: - "application/json" parameters: @@ -2013,11 +1885,37 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "externalKey" + - name: "startDate" in: "query" required: false type: "string" - - name: "bundlesFilter" + format: "date" + - name: "endDate" + in: "query" + required: false + type: "string" + format: "date" + - name: "withMigrationInvoices" + in: "query" + required: false + type: "boolean" + default: false + - name: "unpaidInvoicesOnly" + in: "query" + required: false + type: "boolean" + default: false + - name: "includeVoidedInvoices" + in: "query" + required: false + type: "boolean" + default: false + - name: "includeInvoiceComponents" + in: "query" + required: false + type: "boolean" + default: false + - name: "invoicesFilter" in: "query" required: false type: "string" @@ -2036,7 +1934,7 @@ paths: schema: type: "array" items: - $ref: "#/definitions/Bundle" + $ref: "#/definitions/Invoice" "400": description: "Invalid account id supplied" "404": @@ -2045,56 +1943,42 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/timeline: + /1.0/kb/accounts/block/{blockingId}/auditLogsWithHistory: get: tags: - "Account" - summary: "Retrieve account timeline" + summary: "Retrieve blocking state audit logs with history by id" description: "" - operationId: "getAccountTimeline" + operationId: "getBlockingStateAuditLogsWithHistory" produces: - "application/json" parameters: - - name: "accountId" + - name: "blockingId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "parallel" - in: "query" - required: false - type: "boolean" - default: false - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/AccountTimeline" - "400": - description: "Invalid account id supplied" + type: "array" + items: + $ref: "#/definitions/AuditLog" "404": - description: "Account not found" + description: "Blocking state not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/allTags: + /1.0/kb/accounts/{accountId}/emails/{accountEmailId}/auditLogsWithHistory: get: tags: - "Account" - summary: "Retrieve account tags" + summary: "Retrieve account email audit logs with history by id" description: "" - operationId: "getAllTags" + operationId: "getAccountEmailAuditLogsWithHistory" produces: - "application/json" parameters: @@ -2104,66 +1988,32 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "objectType" - in: "query" - required: false - type: "string" - enum: - - "ACCOUNT" - - "ACCOUNT_EMAIL" - - "BLOCKING_STATES" - - "BUNDLE" - - "CUSTOM_FIELD" - - "INVOICE" - - "PAYMENT" - - "TRANSACTION" - - "INVOICE_ITEM" - - "INVOICE_PAYMENT" - - "SUBSCRIPTION" - - "SUBSCRIPTION_EVENT" - - "SERVICE_BROADCAST" - - "PAYMENT_ATTEMPT" - - "PAYMENT_METHOD" - - "TAG" - - "TAG_DEFINITION" - - "TENANT" - - "TENANT_KVS" - - name: "includedDeleted" - in: "query" - required: false - type: "boolean" - default: false - - name: "audit" - in: "query" - required: false + - name: "accountEmailId" + in: "path" + required: true type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/Tag" - "400": - description: "Invalid account id supplied" + $ref: "#/definitions/AuditLog" "404": description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/accounts/{accountId}/overdue: + /1.0/kb/accounts/{accountId}/auditLogs: get: tags: - "Account" - summary: "Retrieve overdue state for account" + summary: "Retrieve audit logs by account id" description: "" - operationId: "getOverdueAccount" + operationId: "getAccountAuditLogs" produces: - "application/json" parameters: @@ -2177,72 +2027,76 @@ paths: "200": description: "successful operation" schema: - $ref: "#/definitions/OverdueState" - "400": - description: "Invalid account id supplied" + type: "array" + items: + $ref: "#/definitions/AuditLog" "404": description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/admin/healthcheck: + /1.0/kb/accounts/{childAccountId}/transferCredit: put: tags: - - "Admin" - summary: "Put the host back into rotation" + - "Account" + summary: "Move a given child credit to the parent level" description: "" - operationId: "putInRotation" - produces: + operationId: "transferChildCreditToParent" + consumes: - "application/json" - parameters: [] - responses: - "204": - description: "Successful operation" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: - tags: - - "Admin" - summary: "Put the host out of rotation" - description: "" - operationId: "putOutOfRotation" produces: - "application/json" - parameters: [] + parameters: + - name: "childAccountId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" responses: "204": description: "Successful operation" + "400": + description: "Account does not have credit" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/admin/invoices: - post: + /1.0/kb/accounts/{accountId}/paymentMethods/refresh: + put: tags: - - "Admin" - summary: "Trigger an invoice generation for all parked accounts" + - "Account" + summary: "Refresh account payment methods" description: "" - operationId: "triggerInvoiceGenerationForParkedAccounts" - consumes: - - "application/json" + operationId: "refreshPaymentMethods" produces: - "application/json" parameters: - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" + - name: "accountId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "pluginName" in: "query" required: false - type: "integer" - default: 100 - format: "int64" + type: "string" - name: "pluginProperty" in: "query" required: false @@ -2263,19 +2117,25 @@ paths: required: false type: "string" responses: - "200": + "204": description: "Successful operation" + "400": + description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/admin/cache/accounts/{accountId}: - delete: + /1.0/kb/accounts/{accountId}/paymentMethods/{paymentMethodId}/setDefault: + put: tags: - - "Admin" - summary: "Invalidates Caches per account level" + - "Account" + summary: "Set the default payment method" description: "" - operationId: "invalidatesCacheByAccount" + operationId: "setDefaultPaymentMethod" + consumes: + - "application/json" produces: - "application/json" parameters: @@ -2285,22 +2145,54 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "paymentMethodId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "payAllUnpaidInvoices" + in: "query" + required: false + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" responses: "204": description: "Successful operation" "400": - description: "Invalid account id supplied" + description: "Invalid account id or payment method id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/admin/cache/tenants: - delete: + /1.0/kb/admin/healthcheck: + put: tags: - "Admin" - summary: "Invalidates Caches per tenant level" + summary: "Put the host back into rotation" description: "" - operationId: "invalidatesCacheByTenant" + operationId: "putInRotation" produces: - "application/json" parameters: [] @@ -2311,52 +2203,18 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/admin/payments/{paymentId}/transactions/{paymentTransactionId}: - put: + delete: tags: - "Admin" - summary: "Update existing paymentTransaction and associated payment state" + summary: "Put the host out of rotation" description: "" - operationId: "updatePaymentTransactionState" - consumes: - - "application/json" + operationId: "putOutOfRotation" produces: - "application/json" - parameters: - - name: "paymentId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "paymentTransactionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/AdminPayment" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" + parameters: [] responses: "204": description: "Successful operation" - "400": - description: "Invalid account data supplied" security: - basicAuth: [] - Killbill Api Key: [] @@ -2447,62 +2305,204 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}: - get: + /1.0/kb/admin/cache/tenants: + delete: tags: - - "Bundle" - summary: "Retrieve a bundle by id" + - "Admin" + summary: "Invalidates Caches per tenant level" description: "" - operationId: "getBundle" + operationId: "invalidatesCacheByTenant" + produces: + - "application/json" + parameters: [] + responses: + "204": + description: "Successful operation" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/admin/cache/accounts/{accountId}: + delete: + tags: + - "Admin" + summary: "Invalidates Caches per account level" + description: "" + operationId: "invalidatesCacheByAccount" produces: - "application/json" parameters: - - name: "bundleId" + - name: "accountId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" - schema: - $ref: "#/definitions/Bundle" + "204": + description: "Successful operation" "400": - description: "Invalid bundle id supplied" - "404": - description: "Bundle not found" + description: "Invalid account id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + /1.0/kb/admin/payments/{paymentId}/transactions/{paymentTransactionId}: + put: tags: - - "Bundle" - summary: "Transfer a bundle to another account" + - "Admin" + summary: "Update existing paymentTransaction and associated payment state" description: "" - operationId: "transferBundle" + operationId: "updatePaymentTransactionState" consumes: - "application/json" produces: - "application/json" parameters: - - name: "bundleId" + - name: "paymentId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" + - name: "paymentTransactionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/AdminPayment" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid account data supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/admin/invoices: + post: + tags: + - "Admin" + summary: "Trigger an invoice generation for all parked accounts" + description: "" + operationId: "triggerInvoiceGenerationForParkedAccounts" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "offset" + in: "query" + required: false + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "200": + description: "Successful operation" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/bundles/{bundleId}: + get: + tags: + - "Bundle" + summary: "Retrieve a bundle by id" + description: "" + operationId: "getBundle" + produces: + - "application/json" + parameters: + - name: "bundleId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/Bundle" + "400": + description: "Invalid bundle id supplied" + "404": + description: "Bundle not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + post: + tags: + - "Bundle" + summary: "Transfer a bundle to another account" + description: "" + operationId: "transferBundle" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "bundleId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" name: "body" required: true schema: @@ -2704,22 +2704,28 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}/customFields: + /1.0/kb/bundles/pagination: get: tags: - "Bundle" - summary: "Retrieve bundle custom fields" + summary: "List bundles" description: "" - operationId: "getBundleCustomFields" + operationId: "getBundles" produces: - "application/json" parameters: - - name: "bundleId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + - name: "offset" + in: "query" + required: false + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" - name: "audit" in: "query" required: false @@ -2735,68 +2741,59 @@ paths: schema: type: "array" items: - $ref: "#/definitions/CustomField" - "400": - description: "Invalid bundle id supplied" + $ref: "#/definitions/Bundle" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + /1.0/kb/bundles: + get: tags: - "Bundle" - summary: "Add custom fields to bundle" + summary: "Retrieve a bundle by external key" description: "" - operationId: "createBundleCustomFields" - consumes: - - "application/json" + operationId: "getBundleByKey" produces: - "application/json" parameters: - - name: "bundleId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" + - name: "externalKey" + in: "query" required: true type: "string" - - name: "X-Killbill-Reason" - in: "header" + - name: "includedDeleted" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "boolean" + default: false + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "201": - description: "Custom field created successfully" + "200": + description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/CustomField" - "400": - description: "Invalid bundle id supplied" + $ref: "#/definitions/Bundle" + "404": + description: "Bundle not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] + /1.0/kb/bundles/{bundleId}/pause: put: tags: - "Bundle" - summary: "Modify custom fields to bundle" + summary: "Pause a bundle" description: "" - operationId: "modifyBundleCustomFields" + operationId: "pauseBundle" consumes: - "application/json" produces: @@ -2808,13 +2805,18 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + - name: "requestedDate" + in: "query" + required: false + type: "string" + format: "date" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -2832,65 +2834,70 @@ paths: description: "Successful operation" "400": description: "Invalid bundle id supplied" + "404": + description: "Bundle not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + /1.0/kb/bundles/search/{searchKey}: + get: tags: - "Bundle" - summary: "Remove custom fields from bundle" + summary: "Search bundles" description: "" - operationId: "deleteBundleCustomFields" - consumes: - - "application/json" + operationId: "searchBundles" produces: - "application/json" parameters: - - name: "bundleId" + - name: "searchKey" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "customField" + pattern: ".*" + - name: "offset" in: "query" required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "integer" + default: 100 + format: "int64" + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" - "400": - description: "Invalid bundle id supplied" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/Bundle" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}/block: - post: + /1.0/kb/bundles/{bundleId}/resume: + put: tags: - "Bundle" - summary: "Block a bundle" + summary: "Resume a bundle" description: "" - operationId: "addBundleBlockingState" + operationId: "resumeBundle" consumes: - "application/json" + produces: + - "application/json" parameters: - name: "bundleId" in: "path" @@ -2898,11 +2905,6 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/BlockingState" - name: "requestedDate" in: "query" required: false @@ -2928,12 +2930,8 @@ paths: required: false type: "string" responses: - "201": - description: "Blocking state created successfully" - schema: - type: "array" - items: - $ref: "#/definitions/BlockingState" + "204": + description: "Successful operation" "400": description: "Invalid bundle id supplied" "404": @@ -2942,14 +2940,14 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}/auditLogsWithHistory: - get: + /1.0/kb/bundles/{bundleId}/renameKey: + put: tags: - "Bundle" - summary: "Retrieve bundle audit logs with history by id" + summary: "Update a bundle externalKey" description: "" - operationId: "getBundleAuditLogsWithHistory" - produces: + operationId: "renameExternalKey" + consumes: - "application/json" parameters: - name: "bundleId" @@ -2958,88 +2956,110 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/Bundle" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/AuditLog" + "204": + description: "Successful operation" + "400": + description: "Invalid argumnent supplied" "404": - description: "Subscription bundle not found" + description: "Bundle not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/search/{searchKey}: - get: + /1.0/kb/bundles/{bundleId}/block: + post: tags: - "Bundle" - summary: "Search bundles" + summary: "Block a bundle" description: "" - operationId: "searchBundles" - produces: + operationId: "addBundleBlockingState" + consumes: - "application/json" parameters: - - name: "searchKey" + - name: "bundleId" in: "path" required: true type: "string" - pattern: ".*" - - name: "offset" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/BlockingState" + - name: "requestedDate" in: "query" required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" + type: "string" + format: "date" + - name: "pluginProperty" in: "query" required: false - type: "integer" - default: 100 - format: "int64" - - name: "audit" - in: "query" + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" + "201": + description: "Blocking state created successfully" schema: type: "array" items: - $ref: "#/definitions/Bundle" + $ref: "#/definitions/BlockingState" + "400": + description: "Invalid bundle id supplied" + "404": + description: "Bundle not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/pagination: + /1.0/kb/bundles/{bundleId}/customFields: get: tags: - "Bundle" - summary: "List bundles" + summary: "Retrieve bundle custom fields" description: "" - operationId: "getBundles" + operationId: "getBundleCustomFields" produces: - "application/json" parameters: - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" - in: "query" - required: false - type: "integer" - default: 100 - format: "int64" + - name: "bundleId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - name: "audit" in: "query" required: false @@ -3055,18 +3075,19 @@ paths: schema: type: "array" items: - $ref: "#/definitions/Bundle" + $ref: "#/definitions/CustomField" + "400": + description: "Invalid bundle id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}/pause: - put: + post: tags: - "Bundle" - summary: "Pause a bundle" + summary: "Add custom fields to bundle" description: "" - operationId: "pauseBundle" + operationId: "createBundleCustomFields" consumes: - "application/json" produces: @@ -3078,18 +3099,13 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "requestedDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -3103,25 +3119,28 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Custom field created successfully" + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" "400": description: "Invalid bundle id supplied" - "404": - description: "Bundle not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}/renameKey: put: tags: - "Bundle" - summary: "Update a bundle externalKey" + summary: "Modify custom fields to bundle" description: "" - operationId: "renameExternalKey" + operationId: "modifyBundleCustomFields" consumes: - "application/json" + produces: + - "application/json" parameters: - name: "bundleId" in: "path" @@ -3133,7 +3152,9 @@ paths: name: "body" required: true schema: - $ref: "#/definitions/Bundle" + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -3150,63 +3171,64 @@ paths: "204": description: "Successful operation" "400": - description: "Invalid argumnent supplied" - "404": - description: "Bundle not found" + description: "Invalid bundle id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles: - get: + delete: tags: - "Bundle" - summary: "Retrieve a bundle by external key" + summary: "Remove custom fields from bundle" description: "" - operationId: "getBundleByKey" + operationId: "deleteBundleCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "externalKey" - in: "query" + - name: "bundleId" + in: "path" required: true type: "string" - - name: "includedDeleted" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "customField" in: "query" required: false - type: "boolean" - default: false - - name: "audit" - in: "query" + type: "array" + items: + type: "string" + format: "uuid" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Bundle" - "404": - description: "Bundle not found" + "204": + description: "Successful operation" + "400": + description: "Invalid bundle id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/bundles/{bundleId}/resume: - put: + /1.0/kb/bundles/{bundleId}/auditLogsWithHistory: + get: tags: - "Bundle" - summary: "Resume a bundle" + summary: "Retrieve bundle audit logs with history by id" description: "" - operationId: "resumeBundle" - consumes: - - "application/json" + operationId: "getBundleAuditLogsWithHistory" produces: - "application/json" parameters: @@ -3216,37 +3238,49 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "requestedDate" + responses: + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/AuditLog" + "404": + description: "Subscription bundle not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/catalog/availableAddons: + get: + tags: + - "Catalog" + summary: "Retrieve available add-ons for a given product" + description: "" + operationId: "getAvailableAddons" + produces: + - "application/json" + parameters: + - name: "baseProductName" in: "query" required: false type: "string" - format: "date" - - name: "pluginProperty" + - name: "priceListName" in: "query" required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false type: "string" - - name: "X-Killbill-Comment" - in: "header" + - name: "accountId" + in: "query" required: false type: "string" + format: "uuid" responses: - "204": - description: "Successful operation" - "400": - description: "Invalid bundle id supplied" - "404": - description: "Bundle not found" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/PlanDetail" security: - basicAuth: [] - Killbill Api Key: [] @@ -3308,127 +3342,131 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/simplePlan: - post: + /1.0/kb/catalog/versions: + get: tags: - "Catalog" - summary: "Add a simple plan entry in the current version of the catalog" + summary: "Retrieve a list of catalog versions" description: "" - operationId: "addSimplePlan" - consumes: - - "application/json" + operationId: "getCatalogVersions" produces: - "application/json" parameters: - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/SimplePlan" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + - name: "accountId" + in: "query" required: false type: "string" + format: "uuid" responses: - "201": - description: "Created new plan successfully" + "200": + description: "successful operation" schema: - type: "string" + type: "array" + items: + type: "string" + format: "date-time" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/phase: + /1.0/kb/catalog/xml: get: tags: - "Catalog" - summary: "Retrieve phase for a given subscription and date" + summary: "Retrieve the full catalog as XML" description: "" - operationId: "getPhaseForSubscriptionAndDate" + operationId: "getCatalogXml" produces: - - "application/json" + - "text/xml" parameters: - - name: "subscriptionId" + - name: "requestedDate" in: "query" required: false type: "string" - format: "uuid" - - name: "requestedDate" + format: "date-time" + - name: "accountId" in: "query" required: false type: "string" - format: "date" + format: "uuid" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/Phase" + type: "string" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/product: - get: + post: tags: - "Catalog" - summary: "Retrieve product for a given subscription and date" + summary: "Upload the full catalog as XML" description: "" - operationId: "getProductForSubscriptionAndDate" - produces: - - "application/json" + operationId: "uploadCatalogXml" + consumes: + - "text/xml" parameters: - - name: "subscriptionId" - in: "query" + - in: "body" + name: "body" + required: true + schema: + type: "string" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" required: false type: "string" - format: "uuid" - - name: "requestedDate" - in: "query" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - format: "date" responses: - "200": - description: "successful operation" + "201": + description: "Catalog XML created successfully" schema: - $ref: "#/definitions/Product" + type: "string" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/priceList: - get: + /1.0/kb/catalog/xml/validate: + post: tags: - "Catalog" - summary: "Retrieve priceList for a given subscription and date" + summary: "Validate a XML catalog" description: "" - operationId: "getPriceListForSubscriptionAndDate" + operationId: "validateCatalogXml" + consumes: + - "text/xml" produces: - "application/json" parameters: - - name: "subscriptionId" - in: "query" + - in: "body" + name: "body" + required: true + schema: + type: "string" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" required: false type: "string" - format: "uuid" - - name: "requestedDate" - in: "query" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - format: "date" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/PriceList" + $ref: "#/definitions/CatalogValidation" security: - basicAuth: [] - Killbill Api Key: [] @@ -3488,140 +3526,102 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/versions: + /1.0/kb/catalog/priceList: get: tags: - "Catalog" - summary: "Retrieve a list of catalog versions" + summary: "Retrieve priceList for a given subscription and date" description: "" - operationId: "getCatalogVersions" + operationId: "getPriceListForSubscriptionAndDate" produces: - "application/json" parameters: - - name: "accountId" + - name: "subscriptionId" in: "query" required: false type: "string" format: "uuid" + - name: "requestedDate" + in: "query" + required: false + type: "string" + format: "date" responses: "200": description: "successful operation" schema: - type: "array" - items: - type: "string" - format: "date-time" + $ref: "#/definitions/PriceList" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/availableAddons: + /1.0/kb/catalog/product: get: tags: - "Catalog" - summary: "Retrieve available add-ons for a given product" + summary: "Retrieve product for a given subscription and date" description: "" - operationId: "getAvailableAddons" + operationId: "getProductForSubscriptionAndDate" produces: - "application/json" parameters: - - name: "baseProductName" - in: "query" - required: false - type: "string" - - name: "priceListName" + - name: "subscriptionId" in: "query" required: false type: "string" - - name: "accountId" + format: "uuid" + - name: "requestedDate" in: "query" required: false type: "string" - format: "uuid" + format: "date" responses: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/PlanDetail" + $ref: "#/definitions/Product" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/xml: + /1.0/kb/catalog/phase: get: tags: - "Catalog" - summary: "Retrieve the full catalog as XML" + summary: "Retrieve phase for a given subscription and date" description: "" - operationId: "getCatalogXml" + operationId: "getPhaseForSubscriptionAndDate" produces: - - "text/xml" + - "application/json" parameters: - - name: "requestedDate" + - name: "subscriptionId" in: "query" required: false type: "string" - format: "date-time" - - name: "accountId" + format: "uuid" + - name: "requestedDate" in: "query" required: false type: "string" - format: "uuid" + format: "date" responses: "200": description: "successful operation" schema: - type: "string" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - post: - tags: - - "Catalog" - summary: "Upload the full catalog as XML" - description: "" - operationId: "uploadCatalogXml" - consumes: - - "text/xml" - parameters: - - in: "body" - name: "body" - required: true - schema: - type: "string" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "201": - description: "Catalog XML created successfully" - schema: - type: "string" + $ref: "#/definitions/Phase" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/catalog/xml/validate: + /1.0/kb/catalog/simplePlan: post: tags: - "Catalog" - summary: "Validate a XML catalog" + summary: "Add a simple plan entry in the current version of the catalog" description: "" - operationId: "validateCatalogXml" + operationId: "addSimplePlan" consumes: - - "text/xml" + - "application/json" produces: - "application/json" parameters: @@ -3629,7 +3629,7 @@ paths: name: "body" required: true schema: - type: "string" + $ref: "#/definitions/SimplePlan" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -3643,10 +3643,10 @@ paths: required: false type: "string" responses: - "200": - description: "successful operation" + "201": + description: "Created new plan successfully" schema: - $ref: "#/definitions/CatalogValidation" + type: "string" security: - basicAuth: [] - Killbill Api Key: [] @@ -3670,6 +3670,11 @@ paths: type: "array" items: $ref: "#/definitions/InvoiceItem" + - name: "requestedDate" + in: "query" + required: false + type: "string" + format: "date" - name: "autoCommit" in: "query" required: false @@ -3738,21 +3743,28 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/customFields/search/{searchKey}: + /1.0/kb/customFields/search: get: tags: - "CustomField" - summary: "Search custom fields" + summary: "Search custom fields by type, name and optional value" description: "" - operationId: "searchCustomFields" + operationId: "searchCustomFieldsByTypeName" produces: - "application/json" parameters: - - name: "searchKey" - in: "path" - required: true + - name: "objectType" + in: "query" + required: false + type: "string" + - name: "fieldName" + in: "query" + required: false + type: "string" + - name: "fieldValue" + in: "query" + required: false type: "string" - pattern: ".*" - name: "offset" in: "query" required: false @@ -3785,6 +3797,35 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] + /1.0/kb/customFields/{customFieldId}/auditLogsWithHistory: + get: + tags: + - "CustomField" + summary: "Retrieve custom field audit logs with history by id" + description: "" + operationId: "getCustomFieldAuditLogsWithHistory" + produces: + - "application/json" + parameters: + - name: "customFieldId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + responses: + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/AuditLog" + "404": + description: "Account not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] /1.0/kb/customFields/pagination: get: tags: @@ -3827,57 +3868,21 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/customFields/{customFieldId}/auditLogsWithHistory: + /1.0/kb/customFields/search/{searchKey}: get: tags: - "CustomField" - summary: "Retrieve custom field audit logs with history by id" + summary: "Search custom fields" description: "" - operationId: "getCustomFieldAuditLogsWithHistory" + operationId: "searchCustomFields" produces: - "application/json" parameters: - - name: "customFieldId" + - name: "searchKey" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/AuditLog" - "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/customFields/search: - get: - tags: - - "CustomField" - summary: "Search custom fields by type, name and optional value" - description: "" - operationId: "searchCustomFieldsByTypeName" - produces: - - "application/json" - parameters: - - name: "objectType" - in: "query" - required: false - type: "string" - - name: "fieldName" - in: "query" - required: false - type: "string" - - name: "fieldValue" - in: "query" - required: false - type: "string" + pattern: ".*" - name: "offset" in: "query" required: false @@ -3949,13 +3954,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoiceItems/{invoiceItemId}/tags: + /1.0/kb/invoiceItems/{invoiceItemId}/customFields: get: tags: - "InvoiceItem" - summary: "Retrieve invoice item tags" + summary: "Retrieve invoice item custom fields" description: "" - operationId: "getInvoiceItemTags" + operationId: "getInvoiceItemCustomFields" produces: - "application/json" parameters: @@ -3965,16 +3970,6 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "accountId" - in: "query" - required: true - type: "string" - format: "uuid" - - name: "includedDeleted" - in: "query" - required: false - type: "boolean" - default: false - name: "audit" in: "query" required: false @@ -3990,11 +3985,9 @@ paths: schema: type: "array" items: - $ref: "#/definitions/Tag" + $ref: "#/definitions/CustomField" "400": description: "Invalid invoice item id supplied" - "404": - description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -4002,9 +3995,9 @@ paths: post: tags: - "InvoiceItem" - summary: "Add tags to invoice item" + summary: "Add custom fields to invoice item" description: "" - operationId: "createInvoiceItemTags" + operationId: "createInvoiceItemCustomFields" consumes: - "application/json" produces: @@ -4022,8 +4015,7 @@ paths: schema: type: "array" items: - type: "string" - format: "uuid" + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -4038,23 +4030,23 @@ paths: type: "string" responses: "201": - description: "Tag created successfully" + description: "Custom field created successfully" schema: type: "array" items: - $ref: "#/definitions/Tag" + $ref: "#/definitions/CustomField" "400": description: "Invalid invoice item id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + put: tags: - "InvoiceItem" - summary: "Remove tags from invoice item" + summary: "Modify custom fields to invoice item" description: "" - operationId: "deleteInvoiceItemTags" + operationId: "modifyInvoiceItemCustomFields" consumes: - "application/json" produces: @@ -4066,14 +4058,13 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "tagDef" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -4095,13 +4086,14 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoiceItems/{invoiceItemId}/customFields: - get: + delete: tags: - "InvoiceItem" - summary: "Retrieve invoice item custom fields" + summary: "Remove custom fields from invoice item" description: "" - operationId: "getInvoiceItemCustomFields" + operationId: "deleteInvoiceItemCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: @@ -4111,150 +4103,17 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "audit" + - name: "customField" in: "query" required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - "400": - description: "Invalid invoice item id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - post: - tags: - - "InvoiceItem" - summary: "Add custom fields to invoice item" - description: "" - operationId: "createInvoiceItemCustomFields" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "invoiceItemId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "201": - description: "Custom field created successfully" - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - "400": - description: "Invalid invoice item id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - put: - tags: - - "InvoiceItem" - summary: "Modify custom fields to invoice item" - description: "" - operationId: "modifyInvoiceItemCustomFields" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "invoiceItemId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid invoice item id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: - tags: - - "InvoiceItem" - summary: "Remove custom fields from invoice item" - description: "" - operationId: "deleteInvoiceItemCustomFields" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "invoiceItemId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "customField" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true + type: "array" + items: + type: "string" + format: "uuid" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true type: "string" - name: "X-Killbill-Reason" in: "header" @@ -4302,34 +4161,32 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoicePayments/{paymentId}/tags: + /1.0/kb/invoiceItems/{invoiceItemId}/tags: get: tags: - - "InvoicePayment" - summary: "Retrieve payment tags" + - "InvoiceItem" + summary: "Retrieve invoice item tags" description: "" - operationId: "getInvoicePaymentTags" + operationId: "getInvoiceItemTags" produces: - "application/json" parameters: - - name: "paymentId" + - name: "invoiceItemId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "accountId" + in: "query" + required: true + type: "string" + format: "uuid" - name: "includedDeleted" in: "query" required: false type: "boolean" default: false - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - name: "audit" in: "query" required: false @@ -4347,25 +4204,25 @@ paths: items: $ref: "#/definitions/Tag" "400": - description: "Invalid payment id supplied" + description: "Invalid invoice item id supplied" "404": - description: "Payment not found" + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] post: tags: - - "InvoicePayment" - summary: "Add tags to payment" + - "InvoiceItem" + summary: "Add tags to invoice item" description: "" - operationId: "createInvoicePaymentTags" + operationId: "createInvoiceItemTags" consumes: - "application/json" produces: - "application/json" parameters: - - name: "paymentId" + - name: "invoiceItemId" in: "path" required: true type: "string" @@ -4399,23 +4256,23 @@ paths: items: $ref: "#/definitions/Tag" "400": - description: "Invalid payment id supplied" + description: "Invalid invoice item id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] delete: tags: - - "InvoicePayment" - summary: "Remove tags from payment" + - "InvoiceItem" + summary: "Remove tags from invoice item" description: "" - operationId: "deleteInvoicePaymentTags" + operationId: "deleteInvoiceItemTags" consumes: - "application/json" produces: - "application/json" parameters: - - name: "paymentId" + - name: "invoiceItemId" in: "path" required: true type: "string" @@ -4445,7 +4302,7 @@ paths: "204": description: "Successful operation" "400": - description: "Invalid payment id supplied" + description: "Invalid invoice item id supplied" security: - basicAuth: [] - Killbill Api Key: [] @@ -4574,61 +4431,6 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoicePayments/{paymentId}/chargebacks: - post: - tags: - - "InvoicePayment" - summary: "Record a chargeback" - description: "" - operationId: "createChargeback" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "paymentId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/InvoicePaymentTransaction" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "201": - description: "Created chargeback successfully" - schema: - $ref: "#/definitions/InvoicePayment" - "400": - description: "Invalid payment id supplied" - "404": - description: "Account or payment not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] /1.0/kb/invoicePayments/{paymentId}/customFields: get: tags: @@ -4807,15 +4609,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoicePayments/{paymentId}/chargebackReversals: - post: + /1.0/kb/invoicePayments/{paymentId}/tags: + get: tags: - "InvoicePayment" - summary: "Record a chargebackReversal" + summary: "Retrieve payment tags" description: "" - operationId: "createChargebackReversal" - consumes: - - "application/json" + operationId: "getInvoicePaymentTags" produces: - "application/json" parameters: @@ -4825,11 +4625,171 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: + - name: "includedDeleted" + in: "query" + required: false + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" + responses: + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/Tag" + "400": + description: "Invalid payment id supplied" + "404": + description: "Payment not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + post: + tags: + - "InvoicePayment" + summary: "Add tags to payment" + description: "" + operationId: "createInvoicePaymentTags" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "paymentId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + type: "string" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "201": + description: "Tag created successfully" + schema: + type: "array" + items: + $ref: "#/definitions/Tag" + "400": + description: "Invalid payment id supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + delete: + tags: + - "InvoicePayment" + summary: "Remove tags from payment" + description: "" + operationId: "deleteInvoicePaymentTags" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "paymentId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "tagDef" + in: "query" + required: false + type: "array" + items: + type: "string" + format: "uuid" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid payment id supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/invoicePayments/{paymentId}/refunds: + post: + tags: + - "InvoicePayment" + summary: "Refund a payment, and adjust the invoice if needed" + description: "" + operationId: "createRefundWithAdjustments" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "paymentId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" + name: "body" + required: true + schema: $ref: "#/definitions/InvoicePaymentTransaction" + - name: "externalPayment" + in: "query" + required: false + type: "boolean" + default: false + - name: "paymentMethodId" + in: "query" + required: false + type: "string" + format: "uuid" - name: "pluginProperty" in: "query" required: false @@ -4851,7 +4811,7 @@ paths: type: "string" responses: "201": - description: "Created chargeback reversal successfully" + description: "Created refund successfully" schema: $ref: "#/definitions/InvoicePayment" "400": @@ -4891,13 +4851,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoicePayments/{paymentId}/refunds: + /1.0/kb/invoicePayments/{paymentId}/chargebacks: post: tags: - "InvoicePayment" - summary: "Refund a payment, and adjust the invoice if needed" + summary: "Record a chargeback" description: "" - operationId: "createRefundWithAdjustments" + operationId: "createChargeback" consumes: - "application/json" produces: @@ -4914,16 +4874,61 @@ paths: required: true schema: $ref: "#/definitions/InvoicePaymentTransaction" - - name: "externalPayment" + - name: "pluginProperty" in: "query" required: false - type: "boolean" - default: false - - name: "paymentMethodId" - in: "query" + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" + responses: + "201": + description: "Created chargeback successfully" + schema: + $ref: "#/definitions/InvoicePayment" + "400": + description: "Invalid payment id supplied" + "404": + description: "Account or payment not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/invoicePayments/{paymentId}/chargebackReversals: + post: + tags: + - "InvoicePayment" + summary: "Record a chargebackReversal" + description: "" + operationId: "createChargebackReversal" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "paymentId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/InvoicePaymentTransaction" - name: "pluginProperty" in: "query" required: false @@ -4945,7 +4950,7 @@ paths: type: "string" responses: "201": - description: "Created refund successfully" + description: "Created chargeback reversal successfully" schema: $ref: "#/definitions/InvoicePayment" "400": @@ -5097,34 +5102,111 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}/html: + /1.0/kb/invoices/byItemId/{itemId}: get: tags: - "Invoice" - summary: "Render an invoice as HTML" + summary: "Retrieve an invoice by invoice item id" description: "" - operationId: "getInvoiceAsHTML" + operationId: "getInvoiceByItemId" produces: - - "text/html" + - "application/json" parameters: - - name: "invoiceId" + - name: "itemId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "withChildrenItems" + in: "query" + required: false + type: "boolean" + default: false + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: - type: "string" + $ref: "#/definitions/Invoice" "404": description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}: + /1.0/kb/invoices/template: + get: + tags: + - "Invoice" + summary: "Retrieves the invoice template for the tenant" + description: "" + operationId: "getInvoiceTemplate" + produces: + - "text/html" + parameters: [] + responses: + "200": + description: "successful operation" + schema: + type: "string" + "404": + description: "Template not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + post: + tags: + - "Invoice" + summary: "Upload the invoice template for the tenant" + description: "" + operationId: "uploadInvoiceTemplate" + consumes: + - "text/html" + produces: + - "text/html" + parameters: + - in: "body" + name: "body" + required: true + schema: + type: "string" + - name: "deleteIfExists" + in: "query" + required: false + type: "boolean" + default: false + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "201": + description: "Uploaded invoice template Successfully" + schema: + type: "string" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/invoices/{invoiceId}: get: tags: - "Invoice" @@ -5226,35 +5308,48 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}/{invoiceItemId}/cba: - delete: + /1.0/kb/invoices/taxes/{accountId}: + post: tags: - "Invoice" - summary: "Delete a CBA item" + summary: "Create tax items" description: "" - operationId: "deleteCBA" + operationId: "createTaxItems" consumes: - "application/json" produces: - "application/json" parameters: - - name: "invoiceId" + - name: "accountId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "invoiceItemId" - in: "path" + - in: "body" + name: "body" required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "accountId" + schema: + type: "array" + items: + $ref: "#/definitions/InvoiceItem" + - name: "autoCommit" in: "query" - required: true + required: false + type: "boolean" + default: false + - name: "requestedDate" + in: "query" + required: false type: "string" - format: "uuid" + format: "date" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -5268,126 +5363,46 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" - "400": - description: "Invalid account id, invoice id or invoice item id supplied" - "404": - description: "Account or invoice not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/invoices/byNumber/{invoiceNumber}: - get: - tags: - - "Invoice" - summary: "Retrieve an invoice by number" - description: "" - operationId: "getInvoiceByNumber" - produces: - - "application/json" - parameters: - - name: "invoiceNumber" - in: "path" - required: true - type: "integer" - pattern: "[0-9]+" - format: "int32" - - name: "withChildrenItems" - in: "query" - required: false - type: "boolean" - default: false - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" + "201": + description: "Create tax items successfully" schema: - $ref: "#/definitions/Invoice" + type: "array" + items: + $ref: "#/definitions/InvoiceItem" + "400": + description: "Invalid account id supplied" "404": - description: "Invoice not found" + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/search/{searchKey}: + /1.0/kb/invoices/{groupId}/group: get: tags: - "Invoice" - summary: "Search invoices" + summary: "Retrieve a set of invoices by group id" description: "" - operationId: "searchInvoices" + operationId: "getInvoicesGroup" produces: - "application/json" parameters: - - name: "searchKey" + - name: "groupId" in: "path" required: true type: "string" - pattern: ".*" - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" - in: "query" - required: false - type: "integer" - default: 100 - format: "int64" - - name: "audit" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "accountId" in: "query" - required: false + required: true type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Invoice" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/invoices/pagination: - get: - tags: - - "Invoice" - summary: "List invoices" - description: "" - operationId: "getInvoices" - produces: - - "application/json" - parameters: - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" + format: "uuid" + - name: "withChildrenItems" in: "query" required: false - type: "integer" - default: 100 - format: "int64" + type: "boolean" + default: false - name: "audit" in: "query" required: false @@ -5404,6 +5419,8 @@ paths: type: "array" items: $ref: "#/definitions/Invoice" + "400": + description: "Invalid group id supplied" security: - basicAuth: [] - Killbill Api Key: [] @@ -5586,116 +5603,60 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}/voidInvoice: - put: + /1.0/kb/invoices/catalogTranslation/{locale}: + get: tags: - "Invoice" - summary: "Perform the action of voiding an invoice" + summary: "Retrieves the catalog translation for the tenant" description: "" - operationId: "voidInvoice" - consumes: - - "application/json" + operationId: "getCatalogTranslation" produces: - - "application/json" + - "text/plain" parameters: - - name: "invoiceId" + - name: "locale" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" + pattern: ".*" responses: - "204": - description: "Successful operation" + "200": + description: "successful operation" + schema: + type: "string" "400": - description: "Invalid invoice id supplied" - "404": - description: "Invoice not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}/commitInvoice: - put: - tags: - - "Invoice" - summary: "Perform the invoice status transition from DRAFT to COMMITTED" - description: "" - operationId: "commitInvoice" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "invoiceId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" + description: "Invalid locale supplied" "404": - description: "Invoice not found" + description: "Template not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/migration/{accountId}: post: tags: - "Invoice" - summary: "Create a migration invoice" + summary: "Upload the catalog translation for the tenant" description: "" - operationId: "createMigrationInvoice" + operationId: "uploadCatalogTranslation" consumes: - - "application/json" + - "text/plain" produces: - - "application/json" + - "text/plain" parameters: - - name: "accountId" + - name: "locale" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + pattern: ".*" - in: "body" name: "body" required: true schema: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" - - name: "targetDate" + type: "string" + - name: "deleteIfExists" in: "query" required: false - type: "string" - format: "date" + type: "boolean" + default: false - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -5710,22 +5671,20 @@ paths: type: "string" responses: "201": - description: "Created migration invoice successfully" + description: "Uploaded catalog translation Successfully" schema: - $ref: "#/definitions/Invoice" - "400": - description: "Invalid account id or target datetime supplied" + type: "string" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}/auditLogsWithHistory: + /1.0/kb/invoices/{invoiceId}/payments: get: tags: - "Invoice" - summary: "Retrieve invoice audit logs with history by id" + summary: "Retrieve payments associated with an invoice" description: "" - operationId: "getInvoiceAuditLogsWithHistory" + operationId: "getPaymentsForInvoice" produces: - "application/json" parameters: @@ -5735,32 +5694,52 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "withPluginInfo" + in: "query" + required: false + type: "boolean" + default: false + - name: "withAttempts" + in: "query" + required: false + type: "boolean" + default: false + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/AuditLog" + $ref: "#/definitions/InvoicePayment" + "400": + description: "Invalid invoice id supplied" "404": description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/charges/{accountId}: post: tags: - "Invoice" - summary: "Create external charge(s)" + summary: "Trigger a payment for invoice" description: "" - operationId: "createExternalCharges" + operationId: "createInstantPayment" consumes: - "application/json" produces: - "application/json" parameters: - - name: "accountId" + - name: "invoiceId" in: "path" required: true type: "string" @@ -5770,19 +5749,19 @@ paths: name: "body" required: true schema: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" - - name: "requestedDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "autoCommit" + $ref: "#/definitions/InvoicePayment" + - name: "externalPayment" in: "query" required: false type: "boolean" default: false + - name: "controlPluginName" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "pluginProperty" in: "query" required: false @@ -5804,73 +5783,53 @@ paths: type: "string" responses: "201": - description: "Created external charge Successfully" + description: "Created payment Successfully" schema: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" + $ref: "#/definitions/InvoicePayment" + "204": + description: "Nothing to pay for" "400": - description: "Invalid account id supplied" + description: "Invalid account id or invoice id supplied" "404": description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/catalogTranslation/{locale}: - get: - tags: - - "Invoice" - summary: "Retrieves the catalog translation for the tenant" - description: "" - operationId: "getCatalogTranslation" - produces: - - "text/plain" - parameters: - - name: "locale" - in: "path" - required: true - type: "string" - pattern: ".*" - responses: - "200": - description: "successful operation" - schema: - type: "string" - "400": - description: "Invalid locale supplied" - "404": - description: "Template not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] + /1.0/kb/invoices/dryRun: post: tags: - "Invoice" - summary: "Upload the catalog translation for the tenant" + summary: "Generate a dryRun invoice" description: "" - operationId: "uploadCatalogTranslation" + operationId: "generateDryRunInvoice" consumes: - - "text/plain" + - "application/json" produces: - - "text/plain" + - "application/json" parameters: - - name: "locale" - in: "path" - required: true - type: "string" - pattern: ".*" - in: "body" name: "body" required: true schema: - type: "string" - - name: "deleteIfExists" + $ref: "#/definitions/InvoiceDryRun" + - name: "accountId" + in: "query" + required: true + type: "string" + format: "uuid" + - name: "targetDate" in: "query" required: false - type: "boolean" - default: false + type: "string" + format: "date" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -5884,10 +5843,14 @@ paths: required: false type: "string" responses: - "201": - description: "Uploaded catalog translation Successfully" + "200": + description: "successful operation" schema: - type: "string" + $ref: "#/definitions/Invoice" + "204": + description: "Nothing to generate" + "400": + description: "Invalid account id or target datetime supplied" security: - basicAuth: [] - Killbill Api Key: [] @@ -5918,23 +5881,18 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/dryRun: + /1.0/kb/invoices/group: post: tags: - "Invoice" - summary: "Generate a dryRun invoice" + summary: "Trigger an invoice generation" description: "" - operationId: "generateDryRunInvoice" + operationId: "createFutureInvoiceGroup" consumes: - "application/json" produces: - "application/json" parameters: - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/InvoiceDryRun" - name: "accountId" in: "query" required: true @@ -5965,78 +5923,71 @@ paths: required: false type: "string" responses: - "200": - description: "successful operation" + "201": + description: "Created invoice successfully" schema: - $ref: "#/definitions/Invoice" - "204": - description: "Nothing to generate" + type: "array" + items: + $ref: "#/definitions/Invoice" "400": description: "Invalid account id or target datetime supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/manualPayTemplate: - post: + /1.0/kb/invoices/{invoiceId}/auditLogsWithHistory: + get: tags: - "Invoice" - summary: "Upload the manualPay invoice template for the tenant" + summary: "Retrieve invoice audit logs with history by id" description: "" - operationId: "uploadInvoiceMPTemplate" - consumes: - - "text/html" + operationId: "getInvoiceAuditLogsWithHistory" produces: - - "text/html" + - "application/json" parameters: - - in: "body" - name: "body" + - name: "invoiceId" + in: "path" required: true - schema: - type: "string" - - name: "deleteIfExists" - in: "query" - required: false - type: "boolean" - default: false - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" responses: "200": description: "successful operation" schema: - type: "string" + type: "array" + items: + $ref: "#/definitions/AuditLog" + "404": + description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/template: + /1.0/kb/invoices/translation/{locale}: get: tags: - "Invoice" - summary: "Retrieves the invoice template for the tenant" + summary: "Retrieves the invoice translation for the tenant" description: "" - operationId: "getInvoiceTemplate" + operationId: "getInvoiceTranslation" produces: - - "text/html" - parameters: [] + - "text/plain" + parameters: + - name: "locale" + in: "path" + required: true + type: "string" + pattern: ".*" responses: "200": description: "successful operation" schema: type: "string" + "400": + description: "Invalid locale supplied" "404": - description: "Template not found" + description: "Translation not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -6044,9 +5995,57 @@ paths: post: tags: - "Invoice" - summary: "Upload the invoice template for the tenant" + summary: "Upload the invoice translation for the tenant" description: "" - operationId: "uploadInvoiceTemplate" + operationId: "uploadInvoiceTranslation" + consumes: + - "text/plain" + produces: + - "text/plain" + parameters: + - name: "locale" + in: "path" + required: true + type: "string" + pattern: ".*" + - in: "body" + name: "body" + required: true + schema: + type: "string" + - name: "deleteIfExists" + in: "query" + required: false + type: "boolean" + default: false + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "201": + description: "Uploaded invoice translation Successfully" + schema: + type: "string" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/invoices/manualPayTemplate: + post: + tags: + - "Invoice" + summary: "Upload the manualPay invoice template for the tenant" + description: "" + operationId: "uploadInvoiceMPTemplate" consumes: - "text/html" produces: @@ -6075,8 +6074,8 @@ paths: required: false type: "string" responses: - "201": - description: "Uploaded invoice template Successfully" + "200": + description: "successful operation" schema: type: "string" security: @@ -6135,28 +6134,41 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/group: + /1.0/kb/invoices/charges/{accountId}: post: tags: - "Invoice" - summary: "Trigger an invoice generation" + summary: "Create external charge(s)" description: "" - operationId: "createFutureInvoiceGroup" + operationId: "createExternalCharges" consumes: - "application/json" produces: - "application/json" parameters: - name: "accountId" - in: "query" + in: "path" required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "targetDate" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/InvoiceItem" + - name: "requestedDate" in: "query" required: false type: "string" format: "date" + - name: "autoCommit" + in: "query" + required: false + type: "boolean" + default: false - name: "pluginProperty" in: "query" required: false @@ -6178,71 +6190,76 @@ paths: type: "string" responses: "201": - description: "Created invoice successfully" + description: "Created external charge Successfully" schema: type: "array" items: - $ref: "#/definitions/Invoice" + $ref: "#/definitions/InvoiceItem" "400": - description: "Invalid account id or target datetime supplied" + description: "Invalid account id supplied" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/translation/{locale}: - get: + /1.0/kb/invoices/{invoiceId}/commitInvoice: + put: tags: - "Invoice" - summary: "Retrieves the invoice translation for the tenant" + summary: "Perform the invoice status transition from DRAFT to COMMITTED" description: "" - operationId: "getInvoiceTranslation" + operationId: "commitInvoice" + consumes: + - "application/json" produces: - - "text/plain" + - "application/json" parameters: - - name: "locale" + - name: "invoiceId" in: "path" required: true type: "string" - pattern: ".*" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" responses: - "200": - description: "successful operation" - schema: - type: "string" - "400": - description: "Invalid locale supplied" + "204": + description: "Successful operation" "404": - description: "Translation not found" + description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + /1.0/kb/invoices/{invoiceId}/voidInvoice: + put: tags: - "Invoice" - summary: "Upload the invoice translation for the tenant" + summary: "Perform the action of voiding an invoice" description: "" - operationId: "uploadInvoiceTranslation" + operationId: "voidInvoice" consumes: - - "text/plain" + - "application/json" produces: - - "text/plain" + - "application/json" parameters: - - name: "locale" + - name: "invoiceId" in: "path" required: true type: "string" - pattern: ".*" - - in: "body" - name: "body" - required: true - schema: - type: "string" - - name: "deleteIfExists" - in: "query" - required: false - type: "boolean" - default: false + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -6256,36 +6273,33 @@ paths: required: false type: "string" responses: - "201": - description: "Uploaded invoice translation Successfully" - schema: - type: "string" + "204": + description: "Successful operation" + "400": + description: "Invalid invoice id supplied" + "404": + description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{invoiceId}/payments: + /1.0/kb/invoices/byNumber/{invoiceNumber}: get: tags: - "Invoice" - summary: "Retrieve payments associated with an invoice" + summary: "Retrieve an invoice by number" description: "" - operationId: "getPaymentsForInvoice" + operationId: "getInvoiceByNumber" produces: - "application/json" parameters: - - name: "invoiceId" + - name: "invoiceNumber" in: "path" required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "withAttempts" + type: "integer" + pattern: "[0-9]+" + format: "int32" + - name: "withChildrenItems" in: "query" required: false type: "boolean" @@ -6303,23 +6317,20 @@ paths: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/InvoicePayment" - "400": - description: "Invalid invoice id supplied" + $ref: "#/definitions/Invoice" "404": description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + /1.0/kb/invoices/{invoiceId}/{invoiceItemId}/cba: + delete: tags: - "Invoice" - summary: "Trigger a payment for invoice" + summary: "Delete a CBA item" description: "" - operationId: "createInstantPayment" + operationId: "deleteCBA" consumes: - "application/json" produces: @@ -6331,36 +6342,23 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" + - name: "invoiceItemId" + in: "path" required: true - schema: - $ref: "#/definitions/InvoicePayment" - - name: "externalPayment" + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "accountId" in: "query" - required: false - type: "boolean" - default: false - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + required: true + type: "string" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" required: false type: "string" - name: "X-Killbill-Comment" @@ -6368,41 +6366,65 @@ paths: required: false type: "string" responses: - "201": - description: "Created payment Successfully" - schema: - $ref: "#/definitions/InvoicePayment" "204": - description: "Nothing to pay for" + description: "Successful operation" "400": - description: "Invalid account id or invoice id supplied" + description: "Invalid account id, invoice id or invoice item id supplied" "404": - description: "Account not found" + description: "Account or invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/byItemId/{itemId}: + /1.0/kb/invoices/{invoiceId}/html: get: tags: - "Invoice" - summary: "Retrieve an invoice by invoice item id" + summary: "Render an invoice as HTML" description: "" - operationId: "getInvoiceByItemId" + operationId: "getInvoiceAsHTML" produces: - - "application/json" + - "text/html" parameters: - - name: "itemId" + - name: "invoiceId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "withChildrenItems" + responses: + "200": + description: "successful operation" + schema: + type: "string" + "404": + description: "Invoice not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/invoices/pagination: + get: + tags: + - "Invoice" + summary: "List invoices" + description: "" + operationId: "getInvoices" + produces: + - "application/json" + parameters: + - name: "offset" in: "query" required: false - type: "boolean" - default: false + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" - name: "audit" in: "query" required: false @@ -6416,20 +6438,20 @@ paths: "200": description: "successful operation" schema: - $ref: "#/definitions/Invoice" - "404": - description: "Invoice not found" + type: "array" + items: + $ref: "#/definitions/Invoice" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/taxes/{accountId}: + /1.0/kb/invoices/migration/{accountId}: post: tags: - "Invoice" - summary: "Create tax items" + summary: "Create a migration invoice" description: "" - operationId: "createTaxItems" + operationId: "createMigrationInvoice" consumes: - "application/json" produces: @@ -6448,23 +6470,11 @@ paths: type: "array" items: $ref: "#/definitions/InvoiceItem" - - name: "autoCommit" - in: "query" - required: false - type: "boolean" - default: false - - name: "requestedDate" + - name: "targetDate" in: "query" required: false type: "string" format: "date" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -6479,45 +6489,42 @@ paths: type: "string" responses: "201": - description: "Create tax items successfully" + description: "Created migration invoice successfully" schema: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" + $ref: "#/definitions/Invoice" "400": - description: "Invalid account id supplied" - "404": - description: "Account not found" + description: "Invalid account id or target datetime supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/invoices/{groupId}/group: + /1.0/kb/invoices/search/{searchKey}: get: tags: - "Invoice" - summary: "Retrieve a set of invoices by group id" + summary: "Search invoices" description: "" - operationId: "getInvoicesGroup" + operationId: "searchInvoices" produces: - "application/json" parameters: - - name: "groupId" + - name: "searchKey" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "accountId" + pattern: ".*" + - name: "offset" in: "query" - required: true - type: "string" - format: "uuid" - - name: "withChildrenItems" + required: false + type: "integer" + default: 0 + format: "int64" + - name: "limit" in: "query" required: false - type: "boolean" - default: false + type: "integer" + default: 100 + format: "int64" - name: "audit" in: "query" required: false @@ -6534,8 +6541,6 @@ paths: type: "array" items: $ref: "#/definitions/Invoice" - "400": - description: "Invalid group id supplied" security: - basicAuth: [] - Killbill Api Key: [] @@ -6599,21 +6604,21 @@ paths: description: "Invalid node command supplied" security: - basicAuth: [] - /1.0/kb/overdue: + /1.0/kb/overdue/xml: get: tags: - "Overdue" - summary: "Retrieve the overdue config as JSON" + summary: "Retrieve the overdue config as XML" description: "" - operationId: "getOverdueConfigJson" + operationId: "getOverdueConfigXml" produces: - - "application/json" + - "text/xml" parameters: [] responses: "200": description: "successful operation" schema: - $ref: "#/definitions/Overdue" + type: "string" security: - basicAuth: [] - Killbill Api Key: [] @@ -6621,19 +6626,17 @@ paths: post: tags: - "Overdue" - summary: "Upload the full overdue config as JSON" + summary: "Upload the full overdue config as XML" description: "" - operationId: "uploadOverdueConfigJson" + operationId: "uploadOverdueConfigXml" consumes: - - "application/json" - produces: - - "application/json" + - "text/xml" parameters: - in: "body" name: "body" required: true schema: - $ref: "#/definitions/Overdue" + type: "string" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -6650,28 +6653,28 @@ paths: "201": description: "Successfully uploaded overdue config" schema: - $ref: "#/definitions/Overdue" + type: "string" "400": description: "Invalid node command supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/overdue/xml: + /1.0/kb/overdue: get: tags: - "Overdue" - summary: "Retrieve the overdue config as XML" + summary: "Retrieve the overdue config as JSON" description: "" - operationId: "getOverdueConfigXml" + operationId: "getOverdueConfigJson" produces: - - "text/xml" + - "application/json" parameters: [] responses: "200": description: "successful operation" schema: - type: "string" + $ref: "#/definitions/Overdue" security: - basicAuth: [] - Killbill Api Key: [] @@ -6679,17 +6682,19 @@ paths: post: tags: - "Overdue" - summary: "Upload the full overdue config as XML" + summary: "Upload the full overdue config as JSON" description: "" - operationId: "uploadOverdueConfigXml" + operationId: "uploadOverdueConfigJson" consumes: - - "text/xml" + - "application/json" + produces: + - "application/json" parameters: - in: "body" name: "body" required: true schema: - type: "string" + $ref: "#/definitions/Overdue" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -6706,41 +6711,30 @@ paths: "201": description: "Successfully uploaded overdue config" schema: - type: "string" + $ref: "#/definitions/Overdue" "400": description: "Invalid node command supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentGateways/hosted/form/{accountId}: + /1.0/kb/paymentGateways/hosted/form: post: tags: - "PaymentGateway" - summary: "Generate form data to redirect the customer to the gateway" + summary: "Combo API to generate form data to redirect the customer to the gateway" description: "" - operationId: "buildFormDescriptor" + operationId: "buildComboFormDescriptor" consumes: - "application/json" produces: - "application/json" parameters: - - name: "accountId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/HostedPaymentPageFields" - - name: "paymentMethodId" - in: "query" - required: false - type: "string" - format: "uuid" + $ref: "#/definitions/ComboHostedPaymentPage" - name: "controlPluginName" in: "query" required: false @@ -6772,34 +6766,40 @@ paths: description: "successful operation" schema: $ref: "#/definitions/HostedPaymentPageFormDescriptor" - "404": - description: "Account not found" + "400": + description: "Invalid data for Account or PaymentMethod" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentGateways/notification/{pluginName}: + /1.0/kb/paymentGateways/hosted/form/{accountId}: post: tags: - "PaymentGateway" - summary: "Process a gateway notification" - description: "The response is built by the appropriate plugin" - operationId: "processNotification" + summary: "Generate form data to redirect the customer to the gateway" + description: "" + operationId: "buildFormDescriptor" consumes: - - "*/*" + - "application/json" produces: - "application/json" parameters: - - name: "pluginName" + - name: "accountId" in: "path" required: true type: "string" - pattern: ".*" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - in: "body" name: "body" required: true schema: - type: "string" + $ref: "#/definitions/HostedPaymentPageFields" + - name: "paymentMethodId" + in: "query" + required: false + type: "string" + format: "uuid" - name: "controlPluginName" in: "query" required: false @@ -6828,28 +6828,37 @@ paths: type: "string" responses: "200": - description: "Successful" + description: "successful operation" + schema: + $ref: "#/definitions/HostedPaymentPageFormDescriptor" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentGateways/hosted/form: + /1.0/kb/paymentGateways/notification/{pluginName}: post: tags: - "PaymentGateway" - summary: "Combo API to generate form data to redirect the customer to the gateway" - description: "" - operationId: "buildComboFormDescriptor" + summary: "Process a gateway notification" + description: "The response is built by the appropriate plugin" + operationId: "processNotification" consumes: - - "application/json" + - "*/*" produces: - "application/json" parameters: + - name: "pluginName" + in: "path" + required: true + type: "string" + pattern: ".*" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/ComboHostedPaymentPage" + type: "string" - name: "controlPluginName" in: "query" required: false @@ -6878,41 +6887,140 @@ paths: type: "string" responses: "200": - description: "successful operation" - schema: - $ref: "#/definitions/HostedPaymentPageFormDescriptor" - "400": - description: "Invalid data for Account or PaymentMethod" + description: "Successful" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentMethods/pagination: + /1.0/kb/paymentMethods/{paymentMethodId}: get: tags: - "PaymentMethod" - summary: "List payment methods" + summary: "Retrieve a payment method by id" description: "" - operationId: "getPaymentMethods" + operationId: "getPaymentMethod" produces: - "application/json" parameters: - - name: "offset" + - name: "paymentMethodId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "includedDeleted" in: "query" required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" + type: "boolean" + default: false + - name: "withPluginInfo" in: "query" required: false - type: "integer" - default: 100 - format: "int64" - - name: "pluginName" + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/PaymentMethod" + "400": + description: "Invalid paymentMethodId supplied" + "404": + description: "Account or payment method not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + delete: + tags: + - "PaymentMethod" + summary: "Delete a payment method" + description: "" + operationId: "deletePaymentMethod" + produces: + - "application/json" + parameters: + - name: "paymentMethodId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "deleteDefaultPmWithAutoPayOff" + in: "query" + required: false + type: "boolean" + default: false + - name: "forceDefaultPmDeletion" in: "query" required: false + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid paymentMethodId supplied" + "404": + description: "Account or payment method not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/paymentMethods: + get: + tags: + - "PaymentMethod" + summary: "Retrieve a payment method by external key" + description: "" + operationId: "getPaymentMethodByKey" + produces: + - "application/json" + parameters: + - name: "externalKey" + in: "query" + required: true + type: "string" + - name: "includedDeleted" + in: "query" + required: false + type: "boolean" + default: false - name: "withPluginInfo" in: "query" required: false @@ -6938,9 +7046,9 @@ paths: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/PaymentMethod" + $ref: "#/definitions/PaymentMethod" + "404": + description: "Account or payment method not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -7123,13 +7231,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentMethods/{paymentMethodId}: + /1.0/kb/paymentMethods/{paymentMethodId}/auditLogsWithHistory: get: tags: - "PaymentMethod" - summary: "Retrieve a payment method by id" + summary: "Retrieve payment method audit logs with history by id" description: "" - operationId: "getPaymentMethod" + operationId: "getPaymentMethodAuditLogsWithHistory" produces: - "application/json" parameters: @@ -7139,66 +7247,46 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "includedDeleted" - in: "query" - required: false - type: "boolean" - default: false - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/PaymentMethod" - "400": - description: "Invalid paymentMethodId supplied" + type: "array" + items: + $ref: "#/definitions/AuditLog" "404": - description: "Account or payment method not found" + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + /1.0/kb/paymentMethods/pagination: + get: tags: - "PaymentMethod" - summary: "Delete a payment method" + summary: "List payment methods" description: "" - operationId: "deletePaymentMethod" + operationId: "getPaymentMethods" produces: - "application/json" parameters: - - name: "paymentMethodId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "deleteDefaultPmWithAutoPayOff" + - name: "offset" in: "query" required: false - type: "boolean" - default: false - - name: "forceDefaultPmDeletion" + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" + - name: "pluginName" + in: "query" + required: false + type: "string" + - name: "withPluginInfo" in: "query" required: false type: "boolean" @@ -7210,25 +7298,22 @@ paths: items: type: "string" collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" - "400": - description: "Invalid paymentMethodId supplied" - "404": - description: "Account or payment method not found" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/PaymentMethod" security: - basicAuth: [] - Killbill Api Key: [] @@ -7296,82 +7381,60 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentMethods/{paymentMethodId}/auditLogsWithHistory: - get: + /1.0/kb/payments/combo: + post: tags: - - "PaymentMethod" - summary: "Retrieve payment method audit logs with history by id" + - "Payment" + summary: "Combo api to create a new payment transaction on a existing (or not)\ + \ account " description: "" - operationId: "getPaymentMethodAuditLogsWithHistory" + operationId: "createComboPayment" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "paymentMethodId" - in: "path" + - in: "body" + name: "body" required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/AuditLog" - "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/paymentMethods: - get: - tags: - - "PaymentMethod" - summary: "Retrieve a payment method by external key" - description: "" - operationId: "getPaymentMethodByKey" - produces: - - "application/json" - parameters: - - name: "externalKey" - in: "query" - required: true - type: "string" - - name: "includedDeleted" - in: "query" - required: false - type: "boolean" - default: false - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginProperty" + schema: + $ref: "#/definitions/ComboPaymentTransaction" + - name: "controlPluginName" in: "query" required: false type: "array" items: type: "string" collectionFormat: "multi" - - name: "audit" - in: "query" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" + "201": + description: "Payment transaction created successfully" schema: - $ref: "#/definitions/PaymentMethod" - "404": - description: "Account or payment method not found" + $ref: "#/definitions/Payment" + "400": + description: "Invalid data for Account or PaymentMethod" + "402": + description: "Transaction declined by gateway" + "422": + description: "Payment is aborted by a control plugin" + "502": + description: "Failed to submit payment transaction" + "503": + description: "Payment in unknown status, failed to receive gateway response" + "504": + description: "Payment operation timeout" security: - basicAuth: [] - Killbill Api Key: [] @@ -7517,32 +7580,22 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/pagination: + /1.0/kb/payments/{paymentId}: get: tags: - "Payment" - summary: "Get payments" + summary: "Retrieve a payment by id" description: "" - operationId: "getPayments" + operationId: "getPayment" produces: - "application/json" parameters: - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" - in: "query" - required: false - type: "integer" - default: 100 - format: "int64" - - name: "pluginName" - in: "query" - required: false + - name: "paymentId" + in: "path" + required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - name: "withPluginInfo" in: "query" required: false @@ -7573,54 +7626,44 @@ paths: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/Payment" + $ref: "#/definitions/Payment" + "400": + description: "Invalid paymentId supplied" + "404": + description: "Payment not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/search/{searchKey}: - get: + post: tags: - "Payment" - summary: "Search payments" + summary: "Capture an existing authorization" description: "" - operationId: "searchPayments" + operationId: "captureAuthorization" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "searchKey" + - name: "paymentId" in: "path" required: true type: "string" - pattern: ".*" - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" - in: "query" - required: false - type: "integer" - default: 100 - format: "int64" - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "withAttempts" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginName" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/PaymentTransaction" + - name: "controlPluginName" in: "query" required: false - type: "string" + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "pluginProperty" in: "query" required: false @@ -7628,70 +7671,47 @@ paths: items: type: "string" collectionFormat: "multi" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Payment" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/payments/{paymentId}/customFields: - get: - tags: - - "Payment" - summary: "Retrieve payment custom fields" - description: "" - operationId: "getPaymentCustomFields" - produces: - - "application/json" - parameters: - - name: "paymentId" - in: "path" + - name: "X-Killbill-CreatedBy" + in: "header" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "audit" - in: "query" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" + "201": + description: "Payment transaction created successfully" schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/Payment" "400": - description: "Invalid payment id supplied" + description: "Invalid paymentId supplied" + "404": + description: "Account or payment not found" + "402": + description: "Transaction declined by gateway" + "422": + description: "Payment is aborted by a control plugin" + "502": + description: "Failed to submit payment transaction" + "503": + description: "Payment in unknown status, failed to receive gateway response" + "504": + description: "Payment operation timeout" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + put: tags: - "Payment" - summary: "Add custom fields to payment" + summary: "Complete an existing transaction" description: "" - operationId: "createPaymentCustomFields" + operationId: "completeTransaction" consumes: - "application/json" produces: @@ -7707,104 +7727,21 @@ paths: name: "body" required: true schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "201": - description: "Custom field created successfully" - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - "400": - description: "Invalid payment id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - put: - tags: - - "Payment" - summary: "Modify custom fields to payment" - description: "" - operationId: "modifyPaymentCustomFields" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "paymentId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid payment id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: - tags: - - "Payment" - summary: "Remove custom fields from payment payment" - description: "" - operationId: "deletePaymentCustomFields" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "paymentId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "customField" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" + $ref: "#/definitions/PaymentTransaction" + - name: "controlPluginName" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -7820,73 +7757,30 @@ paths: responses: "204": description: "Successful operation" - "400": - description: "Invalid payment id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/payments/{paymentId}: - get: - tags: - - "Payment" - summary: "Retrieve a payment by id" - description: "" - operationId: "getPayment" - produces: - - "application/json" - parameters: - - name: "paymentId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "withAttempts" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - $ref: "#/definitions/Payment" "400": description: "Invalid paymentId supplied" "404": - description: "Payment not found" + description: "Account or payment not found" + "402": + description: "Transaction declined by gateway" + "422": + description: "Payment is aborted by a control plugin" + "502": + description: "Failed to submit payment transaction" + "503": + description: "Payment in unknown status, failed to receive gateway response" + "504": + description: "Payment operation timeout" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + delete: tags: - "Payment" - summary: "Capture an existing authorization" + summary: "Void an existing payment" description: "" - operationId: "captureAuthorization" + operationId: "voidPayment" consumes: - "application/json" produces: @@ -7930,10 +7824,8 @@ paths: required: false type: "string" responses: - "201": - description: "Payment transaction created successfully" - schema: - $ref: "#/definitions/Payment" + "204": + description: "Successful operation" "400": description: "Invalid paymentId supplied" "404": @@ -7952,12 +7844,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - put: + /1.0/kb/payments/{paymentId}/chargebacks: + post: tags: - "Payment" - summary: "Complete an existing transaction" + summary: "Record a chargeback" description: "" - operationId: "completeTransaction" + operationId: "chargebackPayment" consumes: - "application/json" produces: @@ -8001,8 +7894,10 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Payment transaction created successfully" + schema: + $ref: "#/definitions/Payment" "400": description: "Invalid paymentId supplied" "404": @@ -8021,12 +7916,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + /1.0/kb/payments/{paymentId}/refunds: + post: tags: - "Payment" - summary: "Void an existing payment" + summary: "Refund an existing payment" description: "" - operationId: "voidPayment" + operationId: "refundPayment" consumes: - "application/json" produces: @@ -8070,8 +7966,10 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Payment transaction created successfully" + schema: + $ref: "#/definitions/Payment" "400": description: "Invalid paymentId supplied" "404": @@ -8326,50 +8224,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/cancelScheduledPaymentTransaction: - delete: - tags: - - "Payment" - summary: "Cancels a scheduled payment attempt retry" - description: "" - operationId: "cancelScheduledPaymentTransactionByExternalKey" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "transactionExternalKey" - in: "query" - required: true - type: "string" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid paymentTransactionExternalKey supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/payments/chargebackReversals: + /1.0/kb/payments/chargebacks: post: tags: - "Payment" - summary: "Record a chargeback reversal" + summary: "Record a chargeback" description: "" - operationId: "chargebackReversalPaymentByExternalKey" + operationId: "chargebackPaymentByExternalKey" consumes: - "application/json" produces: @@ -8427,88 +8288,26 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/{paymentTransactionId}/cancelScheduledPaymentTransaction: - delete: + /1.0/kb/payments/{paymentId}/chargebackReversals: + post: tags: - "Payment" - summary: "Cancels a scheduled payment attempt retry" + summary: "Record a chargeback reversal" description: "" - operationId: "cancelScheduledPaymentTransactionById" + operationId: "chargebackReversalPayment" consumes: - "application/json" produces: - "application/json" parameters: - - name: "paymentTransactionId" + - name: "paymentId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid paymentTransactionId supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/payments/attempts/{paymentAttemptId}/auditLogsWithHistory: - get: - tags: - - "Payment" - summary: "Retrieve payment attempt audit logs with history by id" - description: "" - operationId: "getPaymentAttemptAuditLogsWithHistory" - produces: - - "application/json" - parameters: - - name: "paymentAttemptId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/AuditLog" - "404": - description: "Account not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/payments/chargebacks: - post: - tags: - - "Payment" - summary: "Record a chargeback" - description: "" - operationId: "chargebackPaymentByExternalKey" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - in: "body" - name: "body" + - in: "body" + name: "body" required: true schema: $ref: "#/definitions/PaymentTransaction" @@ -8543,6 +8342,8 @@ paths: description: "Payment transaction created successfully" schema: $ref: "#/definitions/Payment" + "400": + description: "Invalid paymentId supplied" "404": description: "Account or payment not found" "402": @@ -8559,15 +8360,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/{paymentId}/chargebackReversals: - post: + /1.0/kb/payments/{paymentId}/auditLogsWithHistory: + get: tags: - "Payment" - summary: "Record a chargeback reversal" + summary: "Retrieve payment audit logs with history by id" description: "" - operationId: "chargebackReversalPayment" - consumes: - - "application/json" + operationId: "getPaymentAuditLogsWithHistory" produces: - "application/json" parameters: @@ -8577,56 +8376,15 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/PaymentTransaction" - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" responses: - "201": - description: "Payment transaction created successfully" + "200": + description: "successful operation" schema: - $ref: "#/definitions/Payment" - "400": - description: "Invalid paymentId supplied" + type: "array" + items: + $ref: "#/definitions/AuditLog" "404": - description: "Account or payment not found" - "402": - description: "Transaction declined by gateway" - "422": - description: "Payment is aborted by a control plugin" - "502": - description: "Failed to submit payment transaction" - "503": - description: "Payment in unknown status, failed to receive gateway response" - "504": - description: "Payment operation timeout" + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -8695,13 +8453,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/{paymentId}/auditLogsWithHistory: + /1.0/kb/payments/{paymentId}/customFields: get: tags: - "Payment" - summary: "Retrieve payment audit logs with history by id" + summary: "Retrieve payment custom fields" description: "" - operationId: "getPaymentAuditLogsWithHistory" + operationId: "getPaymentCustomFields" produces: - "application/json" parameters: @@ -8711,26 +8469,34 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/AuditLog" - "404": - description: "Account not found" + $ref: "#/definitions/CustomField" + "400": + description: "Invalid payment id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/{paymentId}/chargebacks: post: tags: - "Payment" - summary: "Record a chargeback" + summary: "Add custom fields to payment" description: "" - operationId: "chargebackPayment" + operationId: "createPaymentCustomFields" consumes: - "application/json" produces: @@ -8746,21 +8512,9 @@ paths: name: "body" required: true schema: - $ref: "#/definitions/PaymentTransaction" - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -8775,52 +8529,41 @@ paths: type: "string" responses: "201": - description: "Payment transaction created successfully" + description: "Custom field created successfully" schema: - $ref: "#/definitions/Payment" + type: "array" + items: + $ref: "#/definitions/CustomField" "400": - description: "Invalid paymentId supplied" - "404": - description: "Account or payment not found" - "402": - description: "Transaction declined by gateway" - "422": - description: "Payment is aborted by a control plugin" - "502": - description: "Failed to submit payment transaction" - "503": - description: "Payment in unknown status, failed to receive gateway response" - "504": - description: "Payment operation timeout" + description: "Invalid payment id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/combo: - post: + put: tags: - "Payment" - summary: "Combo api to create a new payment transaction on a existing (or not)\ - \ account " + summary: "Modify custom fields to payment" description: "" - operationId: "createComboPayment" + operationId: "modifyPaymentCustomFields" consumes: - "application/json" produces: - "application/json" parameters: + - name: "paymentId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/ComboPaymentTransaction" - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -8834,33 +8577,20 @@ paths: required: false type: "string" responses: - "201": - description: "Payment transaction created successfully" - schema: - $ref: "#/definitions/Payment" + "204": + description: "Successful operation" "400": - description: "Invalid data for Account or PaymentMethod" - "402": - description: "Transaction declined by gateway" - "422": - description: "Payment is aborted by a control plugin" - "502": - description: "Failed to submit payment transaction" - "503": - description: "Payment in unknown status, failed to receive gateway response" - "504": - description: "Payment operation timeout" + description: "Invalid payment id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/payments/{paymentId}/refunds: - post: + delete: tags: - "Payment" - summary: "Refund an existing payment" + summary: "Remove custom fields from payment payment" description: "" - operationId: "refundPayment" + operationId: "deletePaymentCustomFields" consumes: - "application/json" produces: @@ -8872,24 +8602,13 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/PaymentTransaction" - - name: "controlPluginName" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "pluginProperty" + - name: "customField" in: "query" required: false type: "array" items: type: "string" + format: "uuid" collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" @@ -8904,71 +8623,30 @@ paths: required: false type: "string" responses: - "201": - description: "Payment transaction created successfully" - schema: - $ref: "#/definitions/Payment" + "204": + description: "Successful operation" "400": - description: "Invalid paymentId supplied" - "404": - description: "Account or payment not found" - "402": - description: "Transaction declined by gateway" - "422": - description: "Payment is aborted by a control plugin" - "502": - description: "Failed to submit payment transaction" - "503": - description: "Payment in unknown status, failed to receive gateway response" - "504": - description: "Payment operation timeout" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/pluginsInfo: - get: - tags: - - "PluginInfo" - summary: "Retrieve the list of registered plugins" - description: "" - operationId: "getPluginsInfo" - produces: - - "application/json" - parameters: [] - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/PluginInfo" + description: "Invalid payment id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/security/users/{username}/password: - put: + /1.0/kb/payments/cancelScheduledPaymentTransaction: + delete: tags: - - "Security" - summary: "Update a user password" + - "Payment" + summary: "Cancels a scheduled payment attempt retry" description: "" - operationId: "updateUserPassword" + operationId: "cancelScheduledPaymentTransactionByExternalKey" consumes: - "application/json" produces: - "application/json" parameters: - - name: "username" - in: "path" + - name: "transactionExternalKey" + in: "query" required: true type: "string" - pattern: ".*" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/UserRoles" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -8984,25 +8662,30 @@ paths: responses: "204": description: "Successful operation" + "400": + description: "Invalid paymentTransactionExternalKey supplied" security: - basicAuth: [] - /1.0/kb/security/users: - post: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/payments/{paymentTransactionId}/cancelScheduledPaymentTransaction: + delete: tags: - - "Security" - summary: "Add a new user with roles (to make api requests)" + - "Payment" + summary: "Cancels a scheduled payment attempt retry" description: "" - operationId: "addUserRoles" + operationId: "cancelScheduledPaymentTransactionById" consumes: - "application/json" produces: - "application/json" parameters: - - in: "body" - name: "body" + - name: "paymentTransactionId" + in: "path" required: true - schema: - $ref: "#/definitions/UserRoles" + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -9016,57 +8699,74 @@ paths: required: false type: "string" responses: - "201": - description: "User role created successfully" - schema: - $ref: "#/definitions/UserRoles" + "204": + description: "Successful operation" + "400": + description: "Invalid paymentTransactionId supplied" security: - basicAuth: [] - /1.0/kb/security/users/{username}/roles: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/payments/attempts/{paymentAttemptId}/auditLogsWithHistory: get: tags: - - "Security" - summary: "Get roles associated to a user" + - "Payment" + summary: "Retrieve payment attempt audit logs with history by id" description: "" - operationId: "getUserRoles" + operationId: "getPaymentAttemptAuditLogsWithHistory" produces: - "application/json" parameters: - - name: "username" + - name: "paymentAttemptId" in: "path" required: true type: "string" - pattern: ".*" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/UserRoles" + type: "array" + items: + $ref: "#/definitions/AuditLog" "404": - description: "The user does not exist or has been inactivated" + description: "Account not found" security: - basicAuth: [] - put: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/payments/chargebackReversals: + post: tags: - - "Security" - summary: "Update roles associated to a user" + - "Payment" + summary: "Record a chargeback reversal" description: "" - operationId: "updateUserRoles" + operationId: "chargebackReversalPaymentByExternalKey" consumes: - "application/json" produces: - "application/json" parameters: - - name: "username" - in: "path" - required: true - type: "string" - pattern: ".*" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/UserRoles" + $ref: "#/definitions/PaymentTransaction" + - name: "controlPluginName" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -9080,142 +8780,164 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Payment transaction created successfully" + schema: + $ref: "#/definitions/Payment" + "404": + description: "Account or payment not found" + "402": + description: "Transaction declined by gateway" + "422": + description: "Payment is aborted by a control plugin" + "502": + description: "Failed to submit payment transaction" + "503": + description: "Payment in unknown status, failed to receive gateway response" + "504": + description: "Payment operation timeout" security: - basicAuth: [] - /1.0/kb/security/users/{username}: - delete: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/payments/pagination: + get: tags: - - "Security" - summary: "Invalidate an existing user" + - "Payment" + summary: "Get payments" description: "" - operationId: "invalidateUser" - consumes: - - "application/json" + operationId: "getPayments" produces: - "application/json" parameters: - - name: "username" - in: "path" - required: true - type: "string" - pattern: ".*" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + - name: "offset" + in: "query" + required: false + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" + - name: "pluginName" + in: "query" required: false type: "string" - - name: "X-Killbill-Comment" - in: "header" + - name: "withPluginInfo" + in: "query" + required: false + type: "boolean" + default: false + - name: "withAttempts" + in: "query" + required: false + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/Payment" security: - basicAuth: [] - /1.0/kb/security/roles: - post: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/payments/search/{searchKey}: + get: tags: - - "Security" - summary: "Add a new role definition)" + - "Payment" + summary: "Search payments" description: "" - operationId: "addRoleDefinition" - consumes: - - "application/json" + operationId: "searchPayments" produces: - "application/json" parameters: - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/RoleDefinition" - - name: "X-Killbill-CreatedBy" - in: "header" + - name: "searchKey" + in: "path" required: true type: "string" - - name: "X-Killbill-Reason" - in: "header" + pattern: ".*" + - name: "offset" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" required: false - type: "string" - responses: - "201": - description: "Role definition created successfully" - schema: - $ref: "#/definitions/RoleDefinition" - security: - - basicAuth: [] - put: - tags: - - "Security" - summary: "Update a new role definition)" - description: "" - operationId: "updateRoleDefinition" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/RoleDefinition" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + type: "integer" + default: 100 + format: "int64" + - name: "withPluginInfo" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "boolean" + default: false + - name: "withAttempts" + in: "query" + required: false + type: "boolean" + default: false + - name: "pluginName" + in: "query" required: false type: "string" - responses: - "204": - description: "Successful operation" - security: - - basicAuth: [] - /1.0/kb/security/roles/{role}: - get: - tags: - - "Security" - summary: "Get role definition" - description: "" - operationId: "getRoleDefinition" - produces: - - "application/json" - parameters: - - name: "role" - in: "path" - required: true + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "audit" + in: "query" + required: false type: "string" - pattern: ".*" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/RoleDefinition" + type: "array" + items: + $ref: "#/definitions/Payment" security: - basicAuth: [] - /1.0/kb/security/permissions: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/pluginsInfo: get: tags: - - "Security" - summary: "List user permissions" + - "PluginInfo" + summary: "Retrieve the list of registered plugins" description: "" - operationId: "getCurrentUserPermissions" + operationId: "getPluginsInfo" produces: - "application/json" parameters: [] @@ -9225,94 +8947,90 @@ paths: schema: type: "array" items: - type: "string" + $ref: "#/definitions/PluginInfo" security: - basicAuth: [] - /1.0/kb/security/subject: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/security/users/{username}/roles: get: tags: - "Security" - summary: "Get user information" + summary: "Get roles associated to a user" description: "" - operationId: "getCurrentUserSubject" + operationId: "getUserRoles" produces: - "application/json" - parameters: [] + parameters: + - name: "username" + in: "path" + required: true + type: "string" + pattern: ".*" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/Subject" + $ref: "#/definitions/UserRoles" + "404": + description: "The user does not exist or has been inactivated" security: - basicAuth: [] - /1.0/kb/subscriptions/{subscriptionId}/tags: - get: + put: tags: - - "Subscription" - summary: "Retrieve subscription tags" + - "Security" + summary: "Update roles associated to a user" description: "" - operationId: "getSubscriptionTags" + operationId: "updateUserRoles" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" + - name: "username" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "includedDeleted" - in: "query" + pattern: ".*" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/UserRoles" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" required: false - type: "boolean" - default: false - - name: "audit" - in: "query" + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Tag" - "400": - description: "Invalid subscription id supplied" - "404": - description: "Subscription not found" + "204": + description: "Successful operation" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] + /1.0/kb/security/roles: post: tags: - - "Subscription" - operationId: "createSubscriptionTags" + - "Security" + summary: "Add a new role definition)" + description: "" + operationId: "addRoleDefinition" consumes: - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - in: "body" name: "body" required: true schema: - type: "array" - items: - type: "string" - format: "uuid" + $ref: "#/definitions/RoleDefinition" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -9327,38 +9045,27 @@ paths: type: "string" responses: "201": - description: "Tag created successfully" - "400": - description: "Invalid subscription id supplied" + description: "Role definition created successfully" + schema: + $ref: "#/definitions/RoleDefinition" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: + put: tags: - - "Subscription" - summary: "Remove tags from subscription" + - "Security" + summary: "Update a new role definition)" description: "" - operationId: "deleteSubscriptionTags" + operationId: "updateRoleDefinition" consumes: - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" - in: "path" + - in: "body" + name: "body" required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "tagDef" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" + schema: + $ref: "#/definitions/RoleDefinition" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -9374,74 +9081,59 @@ paths: responses: "204": description: "Successful operation" - "400": - description: "Invalid subscription id supplied" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/customFields: - get: + /1.0/kb/security/users/{username}: + delete: tags: - - "Subscription" - summary: "Retrieve subscription custom fields" + - "Security" + summary: "Invalidate an existing user" description: "" - operationId: "getSubscriptionCustomFields" + operationId: "invalidateUser" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" + - name: "username" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "audit" - in: "query" + pattern: ".*" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - "400": - description: "Invalid subscription id supplied" + "204": + description: "Successful operation" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] + /1.0/kb/security/users: post: tags: - - "Subscription" - summary: "Add custom fields to subscription" + - "Security" + summary: "Add a new user with roles (to make api requests)" description: "" - operationId: "createSubscriptionCustomFields" + operationId: "addUserRoles" consumes: - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - in: "body" name: "body" required: true schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/UserRoles" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -9456,37 +9148,55 @@ paths: type: "string" responses: "201": - description: "Custom field created successfully" - "400": - description: "Invalid subscription id supplied" + description: "User role created successfully" + schema: + $ref: "#/definitions/UserRoles" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] + /1.0/kb/security/roles/{role}: + get: + tags: + - "Security" + summary: "Get role definition" + description: "" + operationId: "getRoleDefinition" + produces: + - "application/json" + parameters: + - name: "role" + in: "path" + required: true + type: "string" + pattern: ".*" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/RoleDefinition" + security: + - basicAuth: [] + /1.0/kb/security/users/{username}/password: put: tags: - - "Subscription" - summary: "Modify custom fields to subscription" + - "Security" + summary: "Update a user password" description: "" - operationId: "modifySubscriptionCustomFields" + operationId: "updateUserPassword" consumes: - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" + - name: "username" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + pattern: ".*" - in: "body" name: "body" required: true schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/UserRoles" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -9502,142 +9212,130 @@ paths: responses: "204": description: "Successful operation" - "400": - description: "Invalid subscription id supplied" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: + /1.0/kb/security/subject: + get: tags: - - "Subscription" - summary: "Remove custom fields from subscription" + - "Security" + summary: "Get user information" description: "" - operationId: "deleteSubscriptionCustomFields" - consumes: - - "application/json" + operationId: "getCurrentUserSubject" produces: - "application/json" - parameters: - - name: "subscriptionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "customField" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" + parameters: [] responses: - "204": - description: "Successful operation" - "400": - description: "Invalid subscription id supplied" + "200": + description: "successful operation" + schema: + $ref: "#/definitions/Subject" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/subscriptions/events/{eventId}/auditLogsWithHistory: + /1.0/kb/security/permissions: get: tags: - - "Subscription" - summary: "Retrieve subscription event audit logs with history by id" + - "Security" + summary: "List user permissions" description: "" - operationId: "getSubscriptionEventAuditLogsWithHistory" + operationId: "getCurrentUserPermissions" produces: - "application/json" - parameters: - - name: "eventId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + parameters: [] responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/AuditLog" - "404": - description: "Subscription event not found" + type: "string" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/auditLogsWithHistory: + /1.0/kb/subscriptions: get: tags: - "Subscription" - summary: "Retrieve subscription audit logs with history by id" + summary: "Retrieve a subscription by external key" description: "" - operationId: "getSubscriptionAuditLogsWithHistory" + operationId: "getSubscriptionByKey" produces: - "application/json" parameters: - - name: "subscriptionId" - in: "path" + - name: "externalKey" + in: "query" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/AuditLog" + $ref: "#/definitions/Subscription" "404": description: "Subscription not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/block: post: tags: - "Subscription" - summary: "Block a subscription" + summary: "Create a subscription" description: "" - operationId: "addSubscriptionBlockingState" + operationId: "createSubscription" consumes: - "application/json" + produces: + - "application/json" parameters: - - name: "subscriptionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/BlockingState" - - name: "requestedDate" + $ref: "#/definitions/Subscription" + - name: "entitlementDate" + in: "query" + required: false + type: "string" + format: "date" + - name: "billingDate" in: "query" required: false type: "string" format: "date" + - name: "renameKeyIfExistsAndUnused" + in: "query" + required: false + type: "boolean" + default: true + - name: "migrated" + in: "query" + required: false + type: "boolean" + default: false + - name: "skipResponse" + in: "query" + required: false + type: "boolean" + default: false + - name: "callCompletion" + in: "query" + required: false + type: "boolean" + default: false + - name: "callTimeoutSec" + in: "query" + required: false + type: "integer" + default: 3 + format: "int64" - name: "pluginProperty" in: "query" required: false @@ -9659,15 +9357,9 @@ paths: type: "string" responses: "201": - description: "Blocking state created successfully" + description: "Subscription created successfully" schema: - type: "array" - items: - $ref: "#/definitions/BlockingState" - "400": - description: "Invalid subscription id supplied" - "404": - description: "Subscription not found" + $ref: "#/definitions/Subscription" security: - basicAuth: [] - Killbill Api Key: [] @@ -9869,61 +9561,68 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions/createSubscriptionWithAddOns: - post: + /1.0/kb/subscriptions/{subscriptionId}/uncancel: + put: tags: - "Subscription" - summary: "Create an entitlement with addOn products" + summary: "Un-cancel an entitlement" description: "" - operationId: "createSubscriptionWithAddOns" - consumes: - - "application/json" + operationId: "uncancelSubscriptionPlan" produces: - "application/json" parameters: - - in: "body" - name: "body" + - name: "subscriptionId" + in: "path" required: true - schema: - type: "array" - items: - $ref: "#/definitions/Subscription" - - name: "entitlementDate" - in: "query" - required: false type: "string" - format: "date" - - name: "billingDate" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "pluginProperty" in: "query" required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true type: "string" - format: "date" - - name: "migrated" - in: "query" - required: false - type: "boolean" - default: false - - name: "skipResponse" - in: "query" - required: false - type: "boolean" - default: false - - name: "renameKeyIfExistsAndUnused" - in: "query" - required: false - type: "boolean" - default: true - - name: "callCompletion" - in: "query" + - name: "X-Killbill-Reason" + in: "header" required: false - type: "boolean" - default: false - - name: "callTimeoutSec" - in: "query" + type: "string" + - name: "X-Killbill-Comment" + in: "header" required: false - type: "integer" - default: 3 - format: "int64" + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid subscription id supplied" + "404": + description: "Entitlement not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/subscriptions/{subscriptionId}/undoChangePlan: + put: + tags: + - "Subscription" + summary: "Undo a pending change plan on an entitlement" + description: "" + operationId: "undoChangeSubscriptionPlan" + produces: + - "application/json" + parameters: + - name: "subscriptionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - name: "pluginProperty" in: "query" required: false @@ -9944,10 +9643,12 @@ paths: required: false type: "string" responses: - "201": - description: "Subscriptions created successfully" - schema: - $ref: "#/definitions/Bundle" + "204": + description: "Successful operation" + "400": + description: "Invalid subscription id supplied" + "404": + description: "Entitlement not found" security: - basicAuth: [] - Killbill Api Key: [] @@ -10037,20 +9738,81 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions: - get: + /1.0/kb/subscriptions/{subscriptionId}/bcd: + put: tags: - "Subscription" - summary: "Retrieve a subscription by external key" + summary: "Update the BCD associated to a subscription" description: "" - operationId: "getSubscriptionByKey" + operationId: "updateSubscriptionBCD" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "externalKey" + - name: "subscriptionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/Subscription" + - name: "effectiveFromDate" + in: "query" + required: false + type: "string" + format: "date" + - name: "forceNewBcdWithPastEffectiveDate" in: "query" + required: false + type: "boolean" + default: false + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid entitlement supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/subscriptions/{subscriptionId}/tags: + get: + tags: + - "Subscription" + summary: "Retrieve subscription tags" + description: "" + operationId: "getSubscriptionTags" + produces: + - "application/json" + parameters: + - name: "subscriptionId" + in: "path" required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "includedDeleted" + in: "query" + required: false + type: "boolean" + default: false - name: "audit" in: "query" required: false @@ -10064,7 +9826,11 @@ paths: "200": description: "successful operation" schema: - $ref: "#/definitions/Subscription" + type: "array" + items: + $ref: "#/definitions/Tag" + "400": + description: "Invalid subscription id supplied" "404": description: "Subscription not found" security: @@ -10074,62 +9840,26 @@ paths: post: tags: - "Subscription" - summary: "Create an subscription" - description: "" - operationId: "createSubscription" + operationId: "createSubscriptionTags" consumes: - "application/json" produces: - "application/json" parameters: + - name: "subscriptionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/Subscription" - - name: "entitlementDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "billingDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "renameKeyIfExistsAndUnused" - in: "query" - required: false - type: "boolean" - default: true - - name: "migrated" - in: "query" - required: false - type: "boolean" - default: false - - name: "skipResponse" - in: "query" - required: false - type: "boolean" - default: false - - name: "callCompletion" - in: "query" - required: false - type: "boolean" - default: false - - name: "callTimeoutSec" - in: "query" - required: false - type: "integer" - default: 3 - format: "int64" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" + type: "array" + items: + type: "string" + format: "uuid" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10144,20 +9874,21 @@ paths: type: "string" responses: "201": - description: "Subscription created successfully" - schema: - $ref: "#/definitions/Subscription" + description: "Tag created successfully" + "400": + description: "Invalid subscription id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/uncancel: - put: + delete: tags: - "Subscription" - summary: "Un-cancel an entitlement" + summary: "Remove tags from subscription" description: "" - operationId: "uncancelSubscriptionPlan" + operationId: "deleteSubscriptionTags" + consumes: + - "application/json" produces: - "application/json" parameters: @@ -10167,12 +9898,13 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "pluginProperty" + - name: "tagDef" in: "query" required: false type: "array" items: type: "string" + format: "uuid" collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" @@ -10191,20 +9923,18 @@ paths: description: "Successful operation" "400": description: "Invalid subscription id supplied" - "404": - description: "Entitlement not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/undoChangePlan: - put: + /1.0/kb/subscriptions/{subscriptionId}/block: + post: tags: - "Subscription" - summary: "Undo a pending change plan on an entitlement" + summary: "Block a subscription" description: "" - operationId: "undoChangeSubscriptionPlan" - produces: + operationId: "addSubscriptionBlockingState" + consumes: - "application/json" parameters: - name: "subscriptionId" @@ -10213,6 +9943,16 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/BlockingState" + - name: "requestedDate" + in: "query" + required: false + type: "string" + format: "date" - name: "pluginProperty" in: "query" required: false @@ -10233,25 +9973,27 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Blocking state created successfully" + schema: + type: "array" + items: + $ref: "#/definitions/BlockingState" "400": description: "Invalid subscription id supplied" "404": - description: "Entitlement not found" + description: "Subscription not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/bcd: - put: + /1.0/kb/subscriptions/{subscriptionId}/customFields: + get: tags: - "Subscription" - summary: "Update the BCD associated to a subscription" + summary: "Retrieve subscription custom fields" description: "" - operationId: "updateSubscriptionBCD" - consumes: - - "application/json" + operationId: "getSubscriptionCustomFields" produces: - "application/json" parameters: @@ -10261,49 +10003,34 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/Subscription" - - name: "effectiveFromDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "forceNewBcdWithPastEffectiveDate" + - name: "audit" in: "query" required: false - type: "boolean" - default: false - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "204": - description: "Successful operation" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" "400": - description: "Invalid entitlement supplied" + description: "Invalid subscription id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/subscriptions/{subscriptionId}/quantity: - put: + post: tags: - "Subscription" - summary: "Update the quantity associated to a subscription" + summary: "Add custom fields to subscription" description: "" - operationId: "updateSubscriptionQuantity" + operationId: "createSubscriptionCustomFields" consumes: - "application/json" produces: @@ -10319,17 +10046,9 @@ paths: name: "body" required: true schema: - $ref: "#/definitions/Subscription" - - name: "effectiveFromDate" - in: "query" - required: false - type: "string" - format: "date" - - name: "forceNewQuantityWithPastEffectiveDate" - in: "query" - required: false - type: "boolean" - default: false + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10343,60 +10062,38 @@ paths: required: false type: "string" responses: - "204": - description: "Successful operation" + "201": + description: "Custom field created successfully" "400": - description: "Invalid entitlement supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/tagDefinitions: - get: - tags: - - "TagDefinition" - summary: "List tag definitions" - description: "" - operationId: "getTagDefinitions" - produces: - - "application/json" - parameters: - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/TagDefinition" + description: "Invalid subscription id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - post: + put: tags: - - "TagDefinition" - summary: "Create a tag definition" + - "Subscription" + summary: "Modify custom fields to subscription" description: "" - operationId: "createTagDefinition" + operationId: "modifySubscriptionCustomFields" consumes: - "application/json" produces: - "application/json" parameters: + - name: "subscriptionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - in: "body" name: "body" required: true schema: - $ref: "#/definitions/TagDefinition" + type: "array" + items: + $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10410,67 +10107,93 @@ paths: required: false type: "string" responses: - "201": - description: "Tag definition created successfully" - schema: - $ref: "#/definitions/TagDefinition" + "204": + description: "Successful operation" "400": - description: "Invalid name or description supplied" + description: "Invalid subscription id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tagDefinitions/{tagDefinitionId}: - get: + delete: tags: - - "TagDefinition" - summary: "Retrieve a tag definition" + - "Subscription" + summary: "Remove custom fields from subscription" description: "" - operationId: "getTagDefinition" + operationId: "deleteSubscriptionCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "tagDefinitionId" + - name: "subscriptionId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "audit" + - name: "customField" in: "query" required: false + type: "array" + items: + type: "string" + format: "uuid" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" responses: - "200": - description: "successful operation" - schema: - $ref: "#/definitions/TagDefinition" + "204": + description: "Successful operation" "400": - description: "Invalid tagDefinitionId supplied" + description: "Invalid subscription id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + /1.0/kb/subscriptions/{subscriptionId}/quantity: + put: tags: - - "TagDefinition" - summary: "Delete a tag definition" + - "Subscription" + summary: "Update the quantity associated to a subscription" description: "" - operationId: "deleteTagDefinition" + operationId: "updateSubscriptionQuantity" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "tagDefinitionId" + - name: "subscriptionId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/Subscription" + - name: "effectiveFromDate" + in: "query" + required: false + type: "string" + format: "date" + - name: "forceNewQuantityWithPastEffectiveDate" + in: "query" + required: false + type: "boolean" + default: false - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10487,27 +10210,110 @@ paths: "204": description: "Successful operation" "400": - description: "Invalid tagDefinitionId supplied" + description: "Invalid entitlement supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tagDefinitions/{tagDefinitionId}/auditLogsWithHistory: - get: + /1.0/kb/subscriptions/createSubscriptionWithAddOns: + post: tags: - - "TagDefinition" - summary: "Retrieve tag definition audit logs with history by id" + - "Subscription" + summary: "Create an entitlement with addOn products" description: "" - operationId: "getTagDefinitionAuditLogsWithHistory" + operationId: "createSubscriptionWithAddOns" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "tagDefinitionId" - in: "path" + - in: "body" + name: "body" required: true + schema: + type: "array" + items: + $ref: "#/definitions/Subscription" + - name: "entitlementDate" + in: "query" + required: false type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + format: "date" + - name: "billingDate" + in: "query" + required: false + type: "string" + format: "date" + - name: "migrated" + in: "query" + required: false + type: "boolean" + default: false + - name: "skipResponse" + in: "query" + required: false + type: "boolean" + default: false + - name: "renameKeyIfExistsAndUnused" + in: "query" + required: false + type: "boolean" + default: true + - name: "callCompletion" + in: "query" + required: false + type: "boolean" + default: false + - name: "callTimeoutSec" + in: "query" + required: false + type: "integer" + default: 3 + format: "int64" + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "201": + description: "Subscriptions created successfully" + schema: + $ref: "#/definitions/Bundle" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/subscriptions/{subscriptionId}/auditLogsWithHistory: + get: + tags: + - "Subscription" + summary: "Retrieve subscription audit logs with history by id" + description: "" + operationId: "getSubscriptionAuditLogsWithHistory" + produces: + - "application/json" + parameters: + - name: "subscriptionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" responses: "200": description: "successful operation" @@ -10516,80 +10322,56 @@ paths: items: $ref: "#/definitions/AuditLog" "404": - description: "Account not found" + description: "Subscription not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tags/pagination: + /1.0/kb/subscriptions/events/{eventId}/auditLogsWithHistory: get: tags: - - "Tag" - summary: "List tags" + - "Subscription" + summary: "Retrieve subscription event audit logs with history by id" description: "" - operationId: "getTags" + operationId: "getSubscriptionEventAuditLogsWithHistory" produces: - "application/json" parameters: - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" - in: "query" - required: false - type: "integer" - default: 100 - format: "int64" - - name: "audit" - in: "query" - required: false + - name: "eventId" + in: "path" + required: true type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/Tag" + $ref: "#/definitions/AuditLog" + "404": + description: "Subscription event not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tags/search/{searchKey}: + /1.0/kb/tagDefinitions/{tagDefinitionId}: get: tags: - - "Tag" - summary: "Search tags" + - "TagDefinition" + summary: "Retrieve a tag definition" description: "" - operationId: "searchTags" + operationId: "getTagDefinition" produces: - "application/json" parameters: - - name: "searchKey" + - name: "tagDefinitionId" in: "path" required: true type: "string" - pattern: ".*" - - name: "offset" - in: "query" - required: false - type: "integer" - default: 0 - format: "int64" - - name: "limit" - in: "query" - required: false - type: "integer" - default: 100 - format: "int64" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" - name: "audit" in: "query" required: false @@ -10603,24 +10385,60 @@ paths: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/Tag" + $ref: "#/definitions/TagDefinition" + "400": + description: "Invalid tagDefinitionId supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tags/{tagId}/auditLogsWithHistory: + delete: + tags: + - "TagDefinition" + summary: "Delete a tag definition" + description: "" + operationId: "deleteTagDefinition" + produces: + - "application/json" + parameters: + - name: "tagDefinitionId" + in: "path" + required: true + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false + type: "string" + - name: "X-Killbill-Comment" + in: "header" + required: false + type: "string" + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid tagDefinitionId supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/tagDefinitions/{tagDefinitionId}/auditLogsWithHistory: get: tags: - - "Tag" - summary: "Retrieve tag audit logs with history by id" + - "TagDefinition" + summary: "Retrieve tag definition audit logs with history by id" description: "" - operationId: "getTagAuditLogsWithHistory" + operationId: "getTagDefinitionAuditLogsWithHistory" produces: - "application/json" parameters: - - name: "tagId" + - name: "tagDefinitionId" in: "path" required: true type: "string" @@ -10639,53 +10457,52 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tenants/uploadPluginPaymentStateMachineConfig/{pluginName}: + /1.0/kb/tagDefinitions: get: tags: - - "Tenant" - summary: "Retrieve a per tenant payment state machine for a plugin" + - "TagDefinition" + summary: "List tag definitions" description: "" - operationId: "getPluginPaymentStateMachineConfig" + operationId: "getTagDefinitions" produces: - "application/json" parameters: - - name: "pluginName" - in: "path" - required: true + - name: "audit" + in: "query" + required: false type: "string" - pattern: ".*" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/TenantKeyValue" - "400": - description: "Invalid tenantId supplied" + type: "array" + items: + $ref: "#/definitions/TagDefinition" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] post: tags: - - "Tenant" - summary: "Add a per tenant payment state machine for a plugin" + - "TagDefinition" + summary: "Create a tag definition" description: "" - operationId: "uploadPluginPaymentStateMachineConfig" + operationId: "createTagDefinition" consumes: - - "text/plain" + - "application/json" produces: - "application/json" parameters: - - name: "pluginName" - in: "path" - required: true - type: "string" - pattern: ".*" - in: "body" name: "body" required: true schema: - type: "string" + $ref: "#/definitions/TagDefinition" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10700,123 +10517,148 @@ paths: type: "string" responses: "201": - description: "Per tenant state machine uploaded successfully" + description: "Tag definition created successfully" schema: - $ref: "#/definitions/TenantKeyValue" + $ref: "#/definitions/TagDefinition" "400": - description: "Invalid tenantId supplied" + description: "Invalid name or description supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - delete: + /1.0/kb/tags/{tagId}/auditLogsWithHistory: + get: tags: - - "Tenant" - summary: "Delete a per tenant payment state machine for a plugin" + - "Tag" + summary: "Retrieve tag audit logs with history by id" description: "" - operationId: "deletePluginPaymentStateMachineConfig" + operationId: "getTagAuditLogsWithHistory" + produces: + - "application/json" parameters: - - name: "pluginName" + - name: "tagId" in: "path" required: true type: "string" - pattern: ".*" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" responses: - "204": - description: "Successful operation" - "400": - description: "Invalid tenantId supplied" + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/AuditLog" + "404": + description: "Account not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tenants: + /1.0/kb/tags/search/{searchKey}: get: tags: - - "Tenant" - summary: "Retrieve a tenant by its API key" + - "Tag" + summary: "Search tags" description: "" - operationId: "getTenantByApiKey" + operationId: "searchTags" produces: - "application/json" parameters: - - name: "apiKey" + - name: "searchKey" + in: "path" + required: true + type: "string" + pattern: ".*" + - name: "offset" + in: "query" + required: false + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" + required: false + type: "integer" + default: 100 + format: "int64" + - name: "audit" in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/Tenant" - "404": - description: "Tenant not found" + type: "array" + items: + $ref: "#/definitions/Tag" security: - basicAuth: [] - post: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/tags/pagination: + get: tags: - - "Tenant" - summary: "Create a tenant" + - "Tag" + summary: "List tags" description: "" - operationId: "createTenant" - consumes: - - "application/json" + operationId: "getTags" produces: - "application/json" parameters: - - in: "body" - name: "body" - required: true - schema: - $ref: "#/definitions/Tenant" - - name: "useGlobalDefault" + - name: "offset" in: "query" required: false - type: "boolean" - default: false - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" + type: "integer" + default: 0 + format: "int64" + - name: "limit" + in: "query" required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" + type: "integer" + default: 100 + format: "int64" + - name: "audit" + in: "query" required: false type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: - "201": - description: "Tenant created successfully" + "200": + description: "successful operation" schema: - $ref: "#/definitions/Tenant" - "409": - description: "Tenant already exists" + type: "array" + items: + $ref: "#/definitions/Tag" security: - basicAuth: [] - /1.0/kb/tenants/uploadPerTenantConfig: + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/tenants/uploadPluginPaymentStateMachineConfig/{pluginName}: get: tags: - "Tenant" - summary: "Retrieve a per tenant configuration (system properties)" + summary: "Retrieve a per tenant payment state machine for a plugin" description: "" - operationId: "getPerTenantConfiguration" + operationId: "getPluginPaymentStateMachineConfig" produces: - "application/json" - parameters: [] + parameters: + - name: "pluginName" + in: "path" + required: true + type: "string" + pattern: ".*" responses: "200": description: "successful operation" @@ -10831,14 +10673,19 @@ paths: post: tags: - "Tenant" - summary: "Add a per tenant configuration (system properties)" + summary: "Add a per tenant payment state machine for a plugin" description: "" - operationId: "uploadPerTenantConfiguration" + operationId: "uploadPluginPaymentStateMachineConfig" consumes: - "text/plain" produces: - "application/json" parameters: + - name: "pluginName" + in: "path" + required: true + type: "string" + pattern: ".*" - in: "body" name: "body" required: true @@ -10858,7 +10705,7 @@ paths: type: "string" responses: "201": - description: "Per tenant configuration uploaded successfully" + description: "Per tenant state machine uploaded successfully" schema: $ref: "#/definitions/TenantKeyValue" "400": @@ -10870,10 +10717,15 @@ paths: delete: tags: - "Tenant" - summary: "Delete a per tenant configuration (system properties)" + summary: "Delete a per tenant payment state machine for a plugin" description: "" - operationId: "deletePerTenantConfiguration" + operationId: "deletePluginPaymentStateMachineConfig" parameters: + - name: "pluginName" + in: "path" + required: true + type: "string" + pattern: ".*" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10895,42 +10747,50 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tenants/registerNotificationCallback: + /1.0/kb/tenants: get: tags: - "Tenant" - summary: "Retrieve a push notification" + summary: "Retrieve a tenant by its API key" description: "" - operationId: "getPushNotificationCallbacks" + operationId: "getTenantByApiKey" produces: - "application/json" - parameters: [] + parameters: + - name: "apiKey" + in: "query" + required: false + type: "string" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/TenantKeyValue" - "400": - description: "Invalid tenantId supplied" + $ref: "#/definitions/Tenant" + "404": + description: "Tenant not found" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] post: tags: - "Tenant" - summary: "Create a push notification" + summary: "Create a tenant" description: "" - operationId: "registerPushNotificationCallback" + operationId: "createTenant" consumes: - "application/json" produces: - "application/json" parameters: - - name: "cb" + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/Tenant" + - name: "useGlobalDefault" in: "query" required: false - type: "string" + type: "boolean" + default: false - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -10945,54 +10805,24 @@ paths: type: "string" responses: "201": - description: "Push notification registered successfully" + description: "Tenant created successfully" schema: - $ref: "#/definitions/TenantKeyValue" - "400": - description: "Invalid tenantId supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: - tags: - - "Tenant" - summary: "Delete a push notification" - description: "" - operationId: "deletePushNotificationCallbacks" - parameters: - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid tenantId supplied" + $ref: "#/definitions/Tenant" + "409": + description: "Tenant already exists" security: - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/tenants/uploadPluginConfig/{pluginName}: + /1.0/kb/tenants/userKeyValue/{keyName}: get: tags: - "Tenant" - summary: "Retrieve a per tenant configuration for a plugin" + summary: "Retrieve a per tenant user key/value" description: "" - operationId: "getPluginConfiguration" + operationId: "getUserKeyValue" produces: - "application/json" parameters: - - name: "pluginName" + - name: "keyName" in: "path" required: true type: "string" @@ -11011,15 +10841,15 @@ paths: post: tags: - "Tenant" - summary: "Add a per tenant configuration for a plugin" + summary: "Add a per tenant user key/value" description: "" - operationId: "uploadPluginConfiguration" + operationId: "insertUserKeyValue" consumes: - "text/plain" produces: - "application/json" parameters: - - name: "pluginName" + - name: "keyName" in: "path" required: true type: "string" @@ -11043,7 +10873,7 @@ paths: type: "string" responses: "201": - description: "Plugin configuration uploaded successfully" + description: "Per tenant config uploaded successfully" schema: $ref: "#/definitions/TenantKeyValue" "400": @@ -11055,11 +10885,11 @@ paths: delete: tags: - "Tenant" - summary: "Delete a per tenant configuration for a plugin" + summary: "Delete a per tenant user key/value" description: "" - operationId: "deletePluginConfiguration" + operationId: "deleteUserKeyValue" parameters: - - name: "pluginName" + - name: "keyName" in: "path" required: true type: "string" @@ -11085,49 +10915,73 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tenants/uploadPerTenantConfig/{keyPrefix}/search: + /1.0/kb/tenants/{tenantId}: get: tags: - "Tenant" - summary: "Retrieve a per tenant key value based on key prefix" + summary: "Retrieve a tenant by id" description: "" - operationId: "getAllPluginConfiguration" + operationId: "getTenant" produces: - "application/json" parameters: - - name: "keyPrefix" + - name: "tenantId" in: "path" required: true type: "string" - pattern: ".*" - responses: + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + responses: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/TenantKeyValue" + $ref: "#/definitions/Tenant" "400": description: "Invalid tenantId supplied" + "404": + description: "Tenant not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tenants/userKeyValue/{keyName}: + /1.0/kb/tenants/uploadPerTenantConfig/{keyPrefix}/search: get: tags: - "Tenant" - summary: "Retrieve a per tenant user key/value" + summary: "Retrieve a per tenant key value based on key prefix" description: "" - operationId: "getUserKeyValue" + operationId: "getAllPluginConfiguration" produces: - "application/json" parameters: - - name: "keyName" + - name: "keyPrefix" in: "path" required: true type: "string" pattern: ".*" + responses: + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/TenantKeyValue" + "400": + description: "Invalid tenantId supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/tenants/uploadPerTenantConfig: + get: + tags: + - "Tenant" + summary: "Retrieve a per tenant configuration (system properties)" + description: "" + operationId: "getPerTenantConfiguration" + produces: + - "application/json" + parameters: [] responses: "200": description: "successful operation" @@ -11142,19 +10996,14 @@ paths: post: tags: - "Tenant" - summary: "Add a per tenant user key/value" + summary: "Add a per tenant configuration (system properties)" description: "" - operationId: "insertUserKeyValue" + operationId: "uploadPerTenantConfiguration" consumes: - "text/plain" produces: - "application/json" parameters: - - name: "keyName" - in: "path" - required: true - type: "string" - pattern: ".*" - in: "body" name: "body" required: true @@ -11174,7 +11023,7 @@ paths: type: "string" responses: "201": - description: "Per tenant config uploaded successfully" + description: "Per tenant configuration uploaded successfully" schema: $ref: "#/definitions/TenantKeyValue" "400": @@ -11186,15 +11035,10 @@ paths: delete: tags: - "Tenant" - summary: "Delete a per tenant user key/value" + summary: "Delete a per tenant configuration (system properties)" description: "" - operationId: "deleteUserKeyValue" + operationId: "deletePerTenantConfiguration" parameters: - - name: "keyName" - in: "path" - required: true - type: "string" - pattern: ".*" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -11216,105 +11060,53 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/tenants/{tenantId}: + /1.0/kb/tenants/uploadPluginConfig/{pluginName}: get: tags: - "Tenant" - summary: "Retrieve a tenant by id" + summary: "Retrieve a per tenant configuration for a plugin" description: "" - operationId: "getTenant" + operationId: "getPluginConfiguration" produces: - "application/json" parameters: - - name: "tenantId" + - name: "pluginName" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + pattern: ".*" responses: "200": description: "successful operation" schema: - $ref: "#/definitions/Tenant" + $ref: "#/definitions/TenantKeyValue" "400": description: "Invalid tenantId supplied" - "404": - description: "Tenant not found" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/paymentTransactions/{transactionId}/tags: - get: - tags: - - "PaymentTransaction" - summary: "Retrieve payment transaction tags" - description: "" - operationId: "getTransactionTags" - produces: - - "application/json" - parameters: - - name: "transactionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "includedDeleted" - in: "query" - required: false - type: "boolean" - default: false - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - type: "array" - items: - $ref: "#/definitions/Tag" - "400": - description: "Invalid transaction id supplied" - "404": - description: "Invoice not found" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] post: tags: - - "PaymentTransaction" - summary: "Add tags to payment transaction" + - "Tenant" + summary: "Add a per tenant configuration for a plugin" description: "" - operationId: "createTransactionTags" + operationId: "uploadPluginConfiguration" consumes: - - "application/json" + - "text/plain" produces: - "application/json" parameters: - - name: "transactionId" + - name: "pluginName" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" + pattern: ".*" - in: "body" name: "body" required: true schema: - type: "array" - items: - type: "string" - format: "uuid" + type: "string" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -11329,42 +11121,27 @@ paths: type: "string" responses: "201": - description: "Tag created successfully" + description: "Plugin configuration uploaded successfully" schema: - type: "array" - items: - $ref: "#/definitions/Tag" + $ref: "#/definitions/TenantKeyValue" "400": - description: "Invalid transaction id supplied" + description: "Invalid tenantId supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] delete: tags: - - "PaymentTransaction" - summary: "Remove tags from payment transaction" + - "Tenant" + summary: "Delete a per tenant configuration for a plugin" description: "" - operationId: "deleteTransactionTags" - consumes: - - "application/json" - produces: - - "application/json" + operationId: "deletePluginConfiguration" parameters: - - name: "transactionId" + - name: "pluginName" in: "path" required: true type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "tagDef" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" + pattern: ".*" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -11381,73 +11158,47 @@ paths: "204": description: "Successful operation" "400": - description: "Invalid transaction id supplied" + description: "Invalid tenantId supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentTransactions/{transactionId}/customFields: + /1.0/kb/tenants/registerNotificationCallback: get: tags: - - "PaymentTransaction" - summary: "Retrieve payment transaction custom fields" + - "Tenant" + summary: "Retrieve a push notification" description: "" - operationId: "getTransactionCustomFields" + operationId: "getPushNotificationCallbacks" produces: - "application/json" - parameters: - - name: "transactionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" + parameters: [] responses: "200": description: "successful operation" schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/TenantKeyValue" "400": - description: "Invalid transaction id supplied" + description: "Invalid tenantId supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] post: tags: - - "PaymentTransaction" - summary: "Add custom fields to payment transaction" + - "Tenant" + summary: "Create a push notification" description: "" - operationId: "createTransactionCustomFields" + operationId: "registerPushNotificationCallback" consumes: - "application/json" produces: - "application/json" parameters: - - name: "transactionId" - in: "path" - required: true + - name: "cb" + in: "query" + required: false type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -11462,41 +11213,22 @@ paths: type: "string" responses: "201": - description: "Custom field created successfully" + description: "Push notification registered successfully" schema: - type: "array" - items: - $ref: "#/definitions/CustomField" + $ref: "#/definitions/TenantKeyValue" "400": - description: "Invalid transaction id supplied" + description: "Invalid tenantId supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - put: + delete: tags: - - "PaymentTransaction" - summary: "Modify custom fields to payment transaction" + - "Tenant" + summary: "Delete a push notification" description: "" - operationId: "modifyTransactionCustomFields" - consumes: - - "application/json" - produces: - - "application/json" + operationId: "deletePushNotificationCallbacks" parameters: - - name: "transactionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - in: "body" - name: "body" - required: true - schema: - type: "array" - items: - $ref: "#/definitions/CustomField" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -11513,104 +11245,7 @@ paths: "204": description: "Successful operation" "400": - description: "Invalid transaction id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - delete: - tags: - - "PaymentTransaction" - summary: "Remove custom fields from payment transaction" - description: "" - operationId: "deleteTransactionCustomFields" - consumes: - - "application/json" - produces: - - "application/json" - parameters: - - name: "transactionId" - in: "path" - required: true - type: "string" - pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" - format: "uuid" - - name: "customField" - in: "query" - required: false - type: "array" - items: - type: "string" - format: "uuid" - collectionFormat: "multi" - - name: "X-Killbill-CreatedBy" - in: "header" - required: true - type: "string" - - name: "X-Killbill-Reason" - in: "header" - required: false - type: "string" - - name: "X-Killbill-Comment" - in: "header" - required: false - type: "string" - responses: - "204": - description: "Successful operation" - "400": - description: "Invalid transaction id supplied" - security: - - basicAuth: [] - - Killbill Api Key: [] - - Killbill Api Secret: [] - /1.0/kb/paymentTransactions: - get: - tags: - - "PaymentTransaction" - summary: "Retrieve a payment by transaction external key" - description: "" - operationId: "getPaymentByTransactionExternalKey" - produces: - - "application/json" - parameters: - - name: "transactionExternalKey" - in: "query" - required: true - type: "string" - - name: "withPluginInfo" - in: "query" - required: false - type: "boolean" - default: false - - name: "withAttempts" - in: "query" - required: false - type: "boolean" - default: false - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" - - name: "audit" - in: "query" - required: false - type: "string" - default: "NONE" - enum: - - "FULL" - - "MINIMAL" - - "NONE" - responses: - "200": - description: "successful operation" - schema: - $ref: "#/definitions/Payment" - "404": - description: "Payment not found" + description: "Invalid tenantId supplied" security: - basicAuth: [] - Killbill Api Key: [] @@ -11722,13 +11357,13 @@ paths: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/paymentTransactions/{transactionId}/auditLogsWithHistory: + /1.0/kb/paymentTransactions/{transactionId}/customFields: get: tags: - "PaymentTransaction" - summary: "Retrieve payment transaction audit logs with history by id" + summary: "Retrieve payment transaction custom fields" description: "" - operationId: "getTransactionAuditLogsWithHistory" + operationId: "getTransactionCustomFields" produces: - "application/json" parameters: @@ -11738,128 +11373,147 @@ paths: type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" + - name: "audit" + in: "query" + required: false + type: "string" + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" responses: "200": description: "successful operation" schema: type: "array" items: - $ref: "#/definitions/AuditLog" - "404": - description: "Account not found" + $ref: "#/definitions/CustomField" + "400": + description: "Invalid transaction id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/usages/{subscriptionId}/{unitType}: - get: + post: tags: - - "Usage" - summary: "Retrieve usage for a subscription and unit type" + - "PaymentTransaction" + summary: "Add custom fields to payment transaction" description: "" - operationId: "getUsage" + operationId: "createTransactionCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" + - name: "transactionId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "unitType" - in: "path" + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" + - name: "X-Killbill-CreatedBy" + in: "header" required: true type: "string" - - name: "startDate" - in: "query" + - name: "X-Killbill-Reason" + in: "header" required: false type: "string" - format: "date" - - name: "endDate" - in: "query" + - name: "X-Killbill-Comment" + in: "header" required: false type: "string" - format: "date" - - name: "pluginProperty" - in: "query" - required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" responses: - "200": - description: "successful operation" + "201": + description: "Custom field created successfully" schema: - $ref: "#/definitions/RolledUpUsage" + type: "array" + items: + $ref: "#/definitions/CustomField" "400": - description: "Missing start date or end date" + description: "Invalid transaction id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/usages/{subscriptionId}: - get: + put: tags: - - "Usage" - summary: "Retrieve usage for a subscription" + - "PaymentTransaction" + summary: "Modify custom fields to payment transaction" description: "" - operationId: "getAllUsage" + operationId: "modifyTransactionCustomFields" + consumes: + - "application/json" produces: - "application/json" parameters: - - name: "subscriptionId" + - name: "transactionId" in: "path" required: true type: "string" pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - - name: "startDate" - in: "query" - required: false + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + $ref: "#/definitions/CustomField" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true type: "string" - format: "date" - - name: "endDate" - in: "query" + - name: "X-Killbill-Reason" + in: "header" required: false type: "string" - format: "date" - - name: "pluginProperty" - in: "query" + - name: "X-Killbill-Comment" + in: "header" required: false - type: "array" - items: - type: "string" - collectionFormat: "multi" + type: "string" responses: - "200": - description: "successful operation" - schema: - $ref: "#/definitions/RolledUpUsage" + "204": + description: "Successful operation" "400": - description: "Missing start date or end date" + description: "Invalid transaction id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] - /1.0/kb/usages: - post: + delete: tags: - - "Usage" - summary: "Record usage for a subscription" + - "PaymentTransaction" + summary: "Remove custom fields from payment transaction" description: "" - operationId: "recordUsage" + operationId: "deleteTransactionCustomFields" consumes: - "application/json" produces: - "application/json" parameters: - - in: "body" - name: "body" + - name: "transactionId" + in: "path" required: true - schema: - $ref: "#/definitions/SubscriptionUsageRecord" + type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "customField" + in: "query" + required: false + type: "array" + items: + type: "string" + format: "uuid" + collectionFormat: "multi" - name: "X-Killbill-CreatedBy" in: "header" required: true @@ -11873,610 +11527,397 @@ paths: required: false type: "string" responses: - "200": - description: "Successfully recorded usage data change" + "204": + description: "Successful operation" "400": - description: "Invalid subscription (e.g. inactive)" + description: "Invalid transaction id supplied" security: - basicAuth: [] - Killbill Api Key: [] - Killbill Api Secret: [] -securityDefinitions: - basicAuth: - type: "basic" - Killbill Api Key: - type: "apiKey" - name: "X-Killbill-ApiKey" - in: "header" - Killbill Api Secret: - type: "apiKey" - name: "X-Killbill-ApiSecret" - in: "header" -definitions: - AuditLog: - type: "object" - properties: - changeType: - type: "string" - changeDate: - type: "string" - format: "date-time" - objectType: - type: "string" - enum: - - "ACCOUNT" - - "ACCOUNT_EMAIL" - - "BLOCKING_STATES" - - "BUNDLE" - - "CUSTOM_FIELD" - - "INVOICE" - - "PAYMENT" - - "TRANSACTION" - - "INVOICE_ITEM" - - "INVOICE_PAYMENT" - - "SUBSCRIPTION" - - "SUBSCRIPTION_EVENT" - - "SERVICE_BROADCAST" - - "PAYMENT_ATTEMPT" - - "PAYMENT_METHOD" - - "TAG" - - "TAG_DEFINITION" - - "TENANT" - - "TENANT_KVS" - objectId: - type: "string" - format: "uuid" - changedBy: - type: "string" - reasonCode: - type: "string" - comments: - type: "string" - userToken: - type: "string" - history: - $ref: "#/definitions/Entity" - Entity: - type: "object" - properties: - updatedDate: - type: "string" - format: "date-time" - createdDate: - type: "string" - format: "date-time" - id: - type: "string" - format: "uuid" - Tag: - type: "object" - properties: - tagId: + /1.0/kb/paymentTransactions/{transactionId}/tags: + get: + tags: + - "PaymentTransaction" + summary: "Retrieve payment transaction tags" + description: "" + operationId: "getTransactionTags" + produces: + - "application/json" + parameters: + - name: "transactionId" + in: "path" + required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - objectType: + - name: "includedDeleted" + in: "query" + required: false + type: "boolean" + default: false + - name: "audit" + in: "query" + required: false type: "string" + default: "NONE" enum: - - "ACCOUNT" - - "ACCOUNT_EMAIL" - - "BLOCKING_STATES" - - "BUNDLE" - - "CUSTOM_FIELD" - - "INVOICE" - - "PAYMENT" - - "TRANSACTION" - - "INVOICE_ITEM" - - "INVOICE_PAYMENT" - - "SUBSCRIPTION" - - "SUBSCRIPTION_EVENT" - - "SERVICE_BROADCAST" - - "PAYMENT_ATTEMPT" - - "PAYMENT_METHOD" - - "TAG" - - "TAG_DEFINITION" - - "TENANT" - - "TENANT_KVS" - objectId: + - "FULL" + - "MINIMAL" + - "NONE" + responses: + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/Tag" + "400": + description: "Invalid transaction id supplied" + "404": + description: "Invoice not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + post: + tags: + - "PaymentTransaction" + summary: "Add tags to payment transaction" + description: "" + operationId: "createTransactionTags" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "transactionId" + in: "path" + required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - tagDefinitionId: + - in: "body" + name: "body" + required: true + schema: + type: "array" + items: + type: "string" + format: "uuid" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true type: "string" - format: "uuid" - tagDefinitionName: + - name: "X-Killbill-Reason" + in: "header" + required: false type: "string" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - AccountEmail: - type: "object" - required: - - "email" - properties: - accountId: + - name: "X-Killbill-Comment" + in: "header" + required: false type: "string" - format: "uuid" - email: + responses: + "201": + description: "Tag created successfully" + schema: + type: "array" + items: + $ref: "#/definitions/Tag" + "400": + description: "Invalid transaction id supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + delete: + tags: + - "PaymentTransaction" + summary: "Remove tags from payment transaction" + description: "" + operationId: "deleteTransactionTags" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - name: "transactionId" + in: "path" + required: true type: "string" - auditLogs: + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "tagDef" + in: "query" + required: false type: "array" items: - $ref: "#/definitions/AuditLog" - Account: - type: "object" - properties: - accountId: + type: "string" + format: "uuid" + collectionFormat: "multi" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true type: "string" - format: "uuid" - name: + - name: "X-Killbill-Reason" + in: "header" + required: false type: "string" - firstNameLength: - type: "integer" - format: "int32" - externalKey: + - name: "X-Killbill-Comment" + in: "header" + required: false type: "string" - email: - type: "string" - billCycleDayLocal: - type: "integer" - format: "int32" - currency: - type: "string" - enum: - - "AED" - - "AFN" - - "ALL" - - "AMD" - - "ANG" - - "AOA" - - "ARS" - - "AUD" - - "AWG" - - "AZN" - - "BAM" - - "BBD" - - "BDT" - - "BGN" - - "BHD" - - "BIF" - - "BMD" - - "BND" - - "BOB" - - "BRL" - - "BSD" - - "BTN" - - "BWP" - - "BYR" - - "BZD" - - "CAD" - - "CDF" - - "CHF" - - "CLP" - - "CNY" - - "COP" - - "CRC" - - "CUC" - - "CUP" - - "CVE" - - "CZK" - - "DJF" - - "DKK" - - "DOP" - - "DZD" - - "EGP" - - "ERN" - - "ETB" - - "EUR" - - "FJD" - - "FKP" - - "GBP" - - "GEL" - - "GGP" - - "GHS" - - "GIP" - - "GMD" - - "GNF" - - "GTQ" - - "GYD" - - "HKD" - - "HNL" - - "HRK" - - "HTG" - - "HUF" - - "IDR" - - "ILS" - - "IMP" - - "INR" - - "IQD" - - "IRR" - - "ISK" - - "JEP" - - "JMD" - - "JOD" - - "JPY" - - "KES" - - "KGS" - - "KHR" - - "KMF" - - "KPW" - - "KRW" - - "KWD" - - "KYD" - - "KZT" - - "LAK" - - "LBP" - - "LKR" - - "LRD" - - "LSL" - - "LTL" - - "LVL" - - "LYD" - - "MAD" - - "MDL" - - "MGA" - - "MKD" - - "MMK" - - "MNT" - - "MOP" - - "MRO" - - "MUR" - - "MVR" - - "MWK" - - "MXN" - - "MYR" - - "MZN" - - "NAD" - - "NGN" - - "NIO" - - "NOK" - - "NPR" - - "NZD" - - "OMR" - - "PAB" - - "PEN" - - "PGK" - - "PHP" - - "PKR" - - "PLN" - - "PYG" - - "QAR" - - "RON" - - "RSD" - - "RUB" - - "RWF" - - "SAR" - - "SBD" - - "SCR" - - "SDG" - - "SEK" - - "SGD" - - "SHP" - - "SLL" - - "SOS" - - "SPL" - - "SRD" - - "STD" - - "SVC" - - "SYP" - - "SZL" - - "THB" - - "TJS" - - "TMT" - - "TND" - - "TOP" - - "TRY" - - "TTD" - - "TVD" - - "TWD" - - "TZS" - - "UAH" - - "UGX" - - "USD" - - "UYU" - - "UZS" - - "VEF" - - "VND" - - "VUV" - - "WST" - - "XAF" - - "XCD" - - "XDR" - - "XOF" - - "XPF" - - "YER" - - "ZAR" - - "ZMW" - - "ZWD" - - "BTC" - parentAccountId: - type: "string" - format: "uuid" - isPaymentDelegatedToParent: - type: "boolean" - paymentMethodId: + responses: + "204": + description: "Successful operation" + "400": + description: "Invalid transaction id supplied" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/paymentTransactions/{transactionId}/auditLogsWithHistory: + get: + tags: + - "PaymentTransaction" + summary: "Retrieve payment transaction audit logs with history by id" + description: "" + operationId: "getTransactionAuditLogsWithHistory" + produces: + - "application/json" + parameters: + - name: "transactionId" + in: "path" + required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - referenceTime: - type: "string" - format: "date-time" - timeZone: - type: "string" - address1: - type: "string" - address2: - type: "string" - postalCode: - type: "string" - company: - type: "string" - city: + responses: + "200": + description: "successful operation" + schema: + type: "array" + items: + $ref: "#/definitions/AuditLog" + "404": + description: "Account not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/paymentTransactions: + get: + tags: + - "PaymentTransaction" + summary: "Retrieve a payment by transaction external key" + description: "" + operationId: "getPaymentByTransactionExternalKey" + produces: + - "application/json" + parameters: + - name: "transactionExternalKey" + in: "query" + required: true type: "string" - state: + - name: "withPluginInfo" + in: "query" + required: false + type: "boolean" + default: false + - name: "withAttempts" + in: "query" + required: false + type: "boolean" + default: false + - name: "pluginProperty" + in: "query" + required: false + type: "array" + items: + type: "string" + collectionFormat: "multi" + - name: "audit" + in: "query" + required: false type: "string" - country: + default: "NONE" + enum: + - "FULL" + - "MINIMAL" + - "NONE" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/Payment" + "404": + description: "Payment not found" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/usages/{subscriptionId}/{unitType}: + get: + tags: + - "Usage" + summary: "Retrieve usage for a subscription and unit type" + description: "" + operationId: "getUsage" + produces: + - "application/json" + parameters: + - name: "subscriptionId" + in: "path" + required: true type: "string" - locale: + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" + format: "uuid" + - name: "unitType" + in: "path" + required: true type: "string" - phone: + - name: "startDate" + in: "query" + required: false type: "string" - notes: + format: "date" + - name: "endDate" + in: "query" + required: false type: "string" - isMigrated: - type: "boolean" - accountBalance: - type: "number" - accountCBA: - type: "number" - auditLogs: + format: "date" + - name: "pluginProperty" + in: "query" + required: false type: "array" items: - $ref: "#/definitions/AuditLog" - InvoicePayment: - type: "object" - properties: - targetInvoiceId: + type: "string" + collectionFormat: "multi" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/RolledUpUsage" + "400": + description: "Missing start date or end date" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/usages: + post: + tags: + - "Usage" + summary: "Record usage for a subscription" + description: "" + operationId: "recordUsage" + consumes: + - "application/json" + produces: + - "application/json" + parameters: + - in: "body" + name: "body" + required: true + schema: + $ref: "#/definitions/SubscriptionUsageRecord" + - name: "X-Killbill-CreatedBy" + in: "header" + required: true + type: "string" + - name: "X-Killbill-Reason" + in: "header" + required: false type: "string" - format: "uuid" - accountId: + - name: "X-Killbill-Comment" + in: "header" + required: false type: "string" - format: "uuid" - paymentId: + responses: + "200": + description: "Successfully recorded usage data change" + "400": + description: "Invalid subscription (e.g. inactive)" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] + /1.0/kb/usages/{subscriptionId}: + get: + tags: + - "Usage" + summary: "Retrieve usage for a subscription" + description: "" + operationId: "getAllUsage" + produces: + - "application/json" + parameters: + - name: "subscriptionId" + in: "path" + required: true type: "string" + pattern: "\\w+-\\w+-\\w+-\\w+-\\w+" format: "uuid" - paymentNumber: - type: "string" - paymentExternalKey: - type: "string" - authAmount: - type: "number" - capturedAmount: - type: "number" - purchasedAmount: - type: "number" - refundedAmount: - type: "number" - creditedAmount: - type: "number" - currency: + - name: "startDate" + in: "query" + required: false type: "string" - enum: - - "AED" - - "AFN" - - "ALL" - - "AMD" - - "ANG" - - "AOA" - - "ARS" - - "AUD" - - "AWG" - - "AZN" - - "BAM" - - "BBD" - - "BDT" - - "BGN" - - "BHD" - - "BIF" - - "BMD" - - "BND" - - "BOB" - - "BRL" - - "BSD" - - "BTN" - - "BWP" - - "BYR" - - "BZD" - - "CAD" - - "CDF" - - "CHF" - - "CLP" - - "CNY" - - "COP" - - "CRC" - - "CUC" - - "CUP" - - "CVE" - - "CZK" - - "DJF" - - "DKK" - - "DOP" - - "DZD" - - "EGP" - - "ERN" - - "ETB" - - "EUR" - - "FJD" - - "FKP" - - "GBP" - - "GEL" - - "GGP" - - "GHS" - - "GIP" - - "GMD" - - "GNF" - - "GTQ" - - "GYD" - - "HKD" - - "HNL" - - "HRK" - - "HTG" - - "HUF" - - "IDR" - - "ILS" - - "IMP" - - "INR" - - "IQD" - - "IRR" - - "ISK" - - "JEP" - - "JMD" - - "JOD" - - "JPY" - - "KES" - - "KGS" - - "KHR" - - "KMF" - - "KPW" - - "KRW" - - "KWD" - - "KYD" - - "KZT" - - "LAK" - - "LBP" - - "LKR" - - "LRD" - - "LSL" - - "LTL" - - "LVL" - - "LYD" - - "MAD" - - "MDL" - - "MGA" - - "MKD" - - "MMK" - - "MNT" - - "MOP" - - "MRO" - - "MUR" - - "MVR" - - "MWK" - - "MXN" - - "MYR" - - "MZN" - - "NAD" - - "NGN" - - "NIO" - - "NOK" - - "NPR" - - "NZD" - - "OMR" - - "PAB" - - "PEN" - - "PGK" - - "PHP" - - "PKR" - - "PLN" - - "PYG" - - "QAR" - - "RON" - - "RSD" - - "RUB" - - "RWF" - - "SAR" - - "SBD" - - "SCR" - - "SDG" - - "SEK" - - "SGD" - - "SHP" - - "SLL" - - "SOS" - - "SPL" - - "SRD" - - "STD" - - "SVC" - - "SYP" - - "SZL" - - "THB" - - "TJS" - - "TMT" - - "TND" - - "TOP" - - "TRY" - - "TTD" - - "TVD" - - "TWD" - - "TZS" - - "UAH" - - "UGX" - - "USD" - - "UYU" - - "UZS" - - "VEF" - - "VND" - - "VUV" - - "WST" - - "XAF" - - "XCD" - - "XDR" - - "XOF" - - "XPF" - - "YER" - - "ZAR" - - "ZMW" - - "ZWD" - - "BTC" - paymentMethodId: + format: "date" + - name: "endDate" + in: "query" + required: false type: "string" - format: "uuid" - transactions: - type: "array" - items: - $ref: "#/definitions/PaymentTransaction" - paymentAttempts: - type: "array" - items: - $ref: "#/definitions/PaymentAttempt" - auditLogs: + format: "date" + - name: "pluginProperty" + in: "query" + required: false type: "array" items: - $ref: "#/definitions/AuditLog" - PaymentAttempt: + type: "string" + collectionFormat: "multi" + responses: + "200": + description: "successful operation" + schema: + $ref: "#/definitions/RolledUpUsage" + "400": + description: "Missing start date or end date" + security: + - basicAuth: [] + - Killbill Api Key: [] + - Killbill Api Secret: [] +securityDefinitions: + basicAuth: + type: "basic" + Killbill Api Key: + type: "apiKey" + name: "X-Killbill-ApiKey" + in: "header" + Killbill Api Secret: + type: "apiKey" + name: "X-Killbill-ApiSecret" + in: "header" +definitions: + Account: type: "object" properties: accountId: type: "string" format: "uuid" - paymentMethodId: - type: "string" - format: "uuid" - paymentExternalKey: - type: "string" - transactionId: - type: "string" - format: "uuid" - transactionExternalKey: - type: "string" - transactionType: + name: type: "string" - enum: - - "AUTHORIZE" - - "CAPTURE" - - "CHARGEBACK" - - "CREDIT" - - "PURCHASE" - - "REFUND" - - "VOID" - effectiveDate: + firstNameLength: + type: "integer" + format: "int32" + externalKey: type: "string" - format: "date-time" - stateName: + email: type: "string" - amount: - type: "number" - description: "Transaction amount, required except for void operations" + billCycleDayLocal: + type: "integer" + format: "int32" currency: type: "string" - description: "Amount currency (account currency unless specified)" enum: - "AED" - "AFN" @@ -12643,46 +12084,460 @@ definitions: - "ZMW" - "ZWD" - "BTC" - pluginName: + parentAccountId: + type: "string" + format: "uuid" + isPaymentDelegatedToParent: + type: "boolean" + paymentMethodId: + type: "string" + format: "uuid" + referenceTime: + type: "string" + format: "date-time" + timeZone: + type: "string" + address1: + type: "string" + address2: + type: "string" + postalCode: + type: "string" + company: + type: "string" + city: + type: "string" + state: + type: "string" + country: + type: "string" + locale: + type: "string" + phone: + type: "string" + notes: + type: "string" + isMigrated: + type: "boolean" + accountBalance: + type: "number" + accountCBA: + type: "number" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + AuditLog: + type: "object" + properties: + changeType: + type: "string" + changeDate: + type: "string" + format: "date-time" + objectType: + type: "string" + enum: + - "ACCOUNT" + - "ACCOUNT_EMAIL" + - "BLOCKING_STATES" + - "BUNDLE" + - "CUSTOM_FIELD" + - "INVOICE" + - "PAYMENT" + - "TRANSACTION" + - "INVOICE_ITEM" + - "INVOICE_PAYMENT" + - "SUBSCRIPTION" + - "SUBSCRIPTION_EVENT" + - "SERVICE_BROADCAST" + - "PAYMENT_ATTEMPT" + - "PAYMENT_METHOD" + - "TAG" + - "TAG_DEFINITION" + - "TENANT" + - "TENANT_KVS" + objectId: + type: "string" + format: "uuid" + changedBy: + type: "string" + reasonCode: + type: "string" + comments: + type: "string" + userToken: + type: "string" + history: + $ref: "#/definitions/Entity" + Entity: + type: "object" + properties: + id: + type: "string" + format: "uuid" + createdDate: + type: "string" + format: "date-time" + updatedDate: + type: "string" + format: "date-time" + AccountEmail: + type: "object" + required: + - "email" + properties: + accountId: + type: "string" + format: "uuid" + email: + type: "string" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + Tag: + type: "object" + properties: + tagId: + type: "string" + format: "uuid" + objectType: + type: "string" + enum: + - "ACCOUNT" + - "ACCOUNT_EMAIL" + - "BLOCKING_STATES" + - "BUNDLE" + - "CUSTOM_FIELD" + - "INVOICE" + - "PAYMENT" + - "TRANSACTION" + - "INVOICE_ITEM" + - "INVOICE_PAYMENT" + - "SUBSCRIPTION" + - "SUBSCRIPTION_EVENT" + - "SERVICE_BROADCAST" + - "PAYMENT_ATTEMPT" + - "PAYMENT_METHOD" + - "TAG" + - "TAG_DEFINITION" + - "TENANT" + - "TENANT_KVS" + objectId: + type: "string" + format: "uuid" + tagDefinitionId: + type: "string" + format: "uuid" + tagDefinitionName: + type: "string" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + BlockPrice: + type: "object" + properties: + unitName: + type: "string" + size: + type: "number" + price: + type: "number" + max: + type: "number" + Bundle: + type: "object" + required: + - "accountId" + properties: + accountId: + type: "string" + format: "uuid" + bundleId: + type: "string" + format: "uuid" + externalKey: + type: "string" + subscriptions: + type: "array" + items: + $ref: "#/definitions/Subscription" + timeline: + $ref: "#/definitions/BundleTimeline" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + BundleTimeline: + type: "object" + properties: + accountId: + type: "string" + format: "uuid" + bundleId: + type: "string" + format: "uuid" + externalKey: + type: "string" + events: + type: "array" + items: + $ref: "#/definitions/EventSubscription" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + EventSubscription: + type: "object" + properties: + eventId: + type: "string" + format: "uuid" + billingPeriod: + type: "string" + enum: + - "DAILY" + - "WEEKLY" + - "BIWEEKLY" + - "THIRTY_DAYS" + - "THIRTY_ONE_DAYS" + - "SIXTY_DAYS" + - "NINETY_DAYS" + - "MONTHLY" + - "BIMESTRIAL" + - "QUARTERLY" + - "TRIANNUAL" + - "BIANNUAL" + - "ANNUAL" + - "SESQUIENNIAL" + - "BIENNIAL" + - "TRIENNIAL" + - "NO_BILLING_PERIOD" + effectiveDate: + type: "string" + format: "date-time" + catalogEffectiveDate: + type: "string" + format: "date-time" + plan: + type: "string" + product: + type: "string" + priceList: + type: "string" + eventType: + type: "string" + enum: + - "START_ENTITLEMENT" + - "START_BILLING" + - "PAUSE_ENTITLEMENT" + - "PAUSE_BILLING" + - "RESUME_ENTITLEMENT" + - "RESUME_BILLING" + - "PHASE" + - "CHANGE" + - "STOP_ENTITLEMENT" + - "STOP_BILLING" + - "SERVICE_STATE_CHANGE" + isBlockedBilling: + type: "boolean" + isBlockedEntitlement: + type: "boolean" + serviceName: + type: "string" + serviceStateName: + type: "string" + phase: type: "string" - pluginProperties: - type: "array" - items: - $ref: "#/definitions/PluginProperty" auditLogs: type: "array" items: $ref: "#/definitions/AuditLog" - PaymentTransaction: + PhasePrice: type: "object" properties: - transactionId: + planName: + type: "string" + phaseName: + type: "string" + phaseType: + type: "string" + fixedPrice: + type: "number" + recurringPrice: + type: "number" + usagePrices: + type: "array" + items: + $ref: "#/definitions/UsagePrice" + Subscription: + type: "object" + required: + - "billingPeriod" + - "planName" + - "priceList" + - "productName" + properties: + accountId: type: "string" format: "uuid" - transactionExternalKey: + bundleId: type: "string" - paymentId: + format: "uuid" + bundleExternalKey: + type: "string" + subscriptionId: type: "string" format: "uuid" - description: "Associated payment id, required when notifying state transitions" - paymentExternalKey: + externalKey: type: "string" - transactionType: + startDate: + type: "string" + format: "date-time" + productName: + type: "string" + productCategory: type: "string" enum: - - "AUTHORIZE" - - "CAPTURE" - - "CHARGEBACK" - - "CREDIT" - - "PURCHASE" - - "REFUND" - - "VOID" + - "BASE" + - "ADD_ON" + - "STANDALONE" + billingPeriod: + type: "string" + enum: + - "DAILY" + - "WEEKLY" + - "BIWEEKLY" + - "THIRTY_DAYS" + - "THIRTY_ONE_DAYS" + - "SIXTY_DAYS" + - "NINETY_DAYS" + - "MONTHLY" + - "BIMESTRIAL" + - "QUARTERLY" + - "TRIANNUAL" + - "BIANNUAL" + - "ANNUAL" + - "SESQUIENNIAL" + - "BIENNIAL" + - "TRIENNIAL" + - "NO_BILLING_PERIOD" + phaseType: + type: "string" + enum: + - "TRIAL" + - "DISCOUNT" + - "FIXEDTERM" + - "EVERGREEN" + priceList: + type: "string" + planName: + type: "string" + state: + type: "string" + enum: + - "PENDING" + - "ACTIVE" + - "BLOCKED" + - "CANCELLED" + - "EXPIRED" + sourceType: + type: "string" + enum: + - "NATIVE" + - "MIGRATED" + - "TRANSFERRED" + cancelledDate: + type: "string" + format: "date-time" + chargedThroughDate: + type: "string" + format: "date" + billingStartDate: + type: "string" + format: "date-time" + billingEndDate: + type: "string" + format: "date-time" + billCycleDayLocal: + type: "integer" + format: "int32" + quantity: + type: "integer" + format: "int32" + events: + type: "array" + items: + $ref: "#/definitions/EventSubscription" + priceOverrides: + type: "array" + items: + $ref: "#/definitions/PhasePrice" + prices: + type: "array" + items: + $ref: "#/definitions/PhasePrice" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + TierPrice: + type: "object" + properties: + blockPrices: + type: "array" + items: + $ref: "#/definitions/BlockPrice" + UsagePrice: + type: "object" + properties: + usageName: + type: "string" + usageType: + type: "string" + enum: + - "CAPACITY" + - "CONSUMABLE" + billingMode: + type: "string" + enum: + - "IN_ADVANCE" + - "IN_ARREAR" + tierBlockPolicy: + type: "string" + enum: + - "ALL_TIERS" + - "TOP_TIER" + tierPrices: + type: "array" + items: + $ref: "#/definitions/TierPrice" + AccountTimeline: + type: "object" + properties: + account: + $ref: "#/definitions/Account" + bundles: + type: "array" + items: + $ref: "#/definitions/Bundle" + invoices: + type: "array" + items: + $ref: "#/definitions/Invoice" + payments: + type: "array" + items: + $ref: "#/definitions/InvoicePayment" + Invoice: + type: "object" + properties: amount: type: "number" - description: "Transaction amount, required except for void operations" currency: type: "string" - description: "Amount currency (account currency unless specified)" enum: - "AED" - "AFN" @@ -12849,12 +12704,127 @@ definitions: - "ZMW" - "ZWD" - "BTC" - effectiveDate: + status: + type: "string" + enum: + - "DRAFT" + - "COMMITTED" + - "VOID" + creditAdj: + type: "number" + refundAdj: + type: "number" + invoiceId: + type: "string" + format: "uuid" + invoiceDate: + type: "string" + format: "date" + targetDate: type: "string" - format: "date-time" - processedAmount: + format: "date" + invoiceNumber: + type: "string" + balance: type: "number" - processedCurrency: + accountId: + type: "string" + format: "uuid" + bundleKeys: + type: "string" + credits: + type: "array" + items: + $ref: "#/definitions/InvoiceItem" + items: + type: "array" + items: + $ref: "#/definitions/InvoiceItem" + trackingIds: + type: "array" + items: + type: "string" + isParentInvoice: + type: "boolean" + parentInvoiceId: + type: "string" + format: "uuid" + parentAccountId: + type: "string" + format: "uuid" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + InvoiceItem: + type: "object" + required: + - "accountId" + - "invoiceItemId" + properties: + invoiceItemId: + type: "string" + format: "uuid" + invoiceId: + type: "string" + format: "uuid" + linkedInvoiceItemId: + type: "string" + format: "uuid" + accountId: + type: "string" + format: "uuid" + childAccountId: + type: "string" + format: "uuid" + bundleId: + type: "string" + format: "uuid" + subscriptionId: + type: "string" + format: "uuid" + productName: + type: "string" + planName: + type: "string" + phaseName: + type: "string" + usageName: + type: "string" + prettyProductName: + type: "string" + prettyPlanName: + type: "string" + prettyPhaseName: + type: "string" + prettyUsageName: + type: "string" + itemType: + type: "string" + enum: + - "EXTERNAL_CHARGE" + - "FIXED" + - "RECURRING" + - "REPAIR_ADJ" + - "CBA_ADJ" + - "CREDIT_ADJ" + - "ITEM_ADJ" + - "USAGE" + - "TAX" + - "PARENT_SUMMARY" + description: + type: "string" + startDate: + type: "string" + format: "date" + endDate: + type: "string" + format: "date" + amount: + type: "number" + rate: + type: "number" + currency: type: "string" enum: - "AED" @@ -12959,210 +12929,90 @@ definitions: - "MXN" - "MYR" - "MZN" - - "NAD" - - "NGN" - - "NIO" - - "NOK" - - "NPR" - - "NZD" - - "OMR" - - "PAB" - - "PEN" - - "PGK" - - "PHP" - - "PKR" - - "PLN" - - "PYG" - - "QAR" - - "RON" - - "RSD" - - "RUB" - - "RWF" - - "SAR" - - "SBD" - - "SCR" - - "SDG" - - "SEK" - - "SGD" - - "SHP" - - "SLL" - - "SOS" - - "SPL" - - "SRD" - - "STD" - - "SVC" - - "SYP" - - "SZL" - - "THB" - - "TJS" - - "TMT" - - "TND" - - "TOP" - - "TRY" - - "TTD" - - "TVD" - - "TWD" - - "TZS" - - "UAH" - - "UGX" - - "USD" - - "UYU" - - "UZS" - - "VEF" - - "VND" - - "VUV" - - "WST" - - "XAF" - - "XCD" - - "XDR" - - "XOF" - - "XPF" - - "YER" - - "ZAR" - - "ZMW" - - "ZWD" - - "BTC" - status: - type: "string" - description: "Transaction status, required for state change notifications" - enum: - - "SUCCESS" - - "UNKNOWN" - - "PENDING" - - "PAYMENT_FAILURE" - - "PLUGIN_FAILURE" - - "PAYMENT_SYSTEM_OFF" - gatewayErrorCode: - type: "string" - gatewayErrorMsg: - type: "string" - firstPaymentReferenceId: - type: "string" - secondPaymentReferenceId: - type: "string" - properties: - type: "array" - items: - $ref: "#/definitions/PluginProperty" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - PluginProperty: - type: "object" - properties: - key: - type: "string" - value: - type: "string" - isUpdatable: - type: "boolean" - CustomField: - type: "object" - required: - - "name" - - "value" - properties: - customFieldId: - type: "string" - format: "uuid" - objectId: - type: "string" - format: "uuid" - objectType: - type: "string" - enum: - - "ACCOUNT" - - "ACCOUNT_EMAIL" - - "BLOCKING_STATES" - - "BUNDLE" - - "CUSTOM_FIELD" - - "INVOICE" - - "PAYMENT" - - "TRANSACTION" - - "INVOICE_ITEM" - - "INVOICE_PAYMENT" - - "SUBSCRIPTION" - - "SUBSCRIPTION_EVENT" - - "SERVICE_BROADCAST" - - "PAYMENT_ATTEMPT" - - "PAYMENT_METHOD" - - "TAG" - - "TAG_DEFINITION" - - "TENANT" - - "TENANT_KVS" - name: - type: "string" - value: - type: "string" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - BlockingState: - type: "object" - properties: - blockedId: - type: "string" - format: "uuid" - stateName: - type: "string" - service: + - "NAD" + - "NGN" + - "NIO" + - "NOK" + - "NPR" + - "NZD" + - "OMR" + - "PAB" + - "PEN" + - "PGK" + - "PHP" + - "PKR" + - "PLN" + - "PYG" + - "QAR" + - "RON" + - "RSD" + - "RUB" + - "RWF" + - "SAR" + - "SBD" + - "SCR" + - "SDG" + - "SEK" + - "SGD" + - "SHP" + - "SLL" + - "SOS" + - "SPL" + - "SRD" + - "STD" + - "SVC" + - "SYP" + - "SZL" + - "THB" + - "TJS" + - "TMT" + - "TND" + - "TOP" + - "TRY" + - "TTD" + - "TVD" + - "TWD" + - "TZS" + - "UAH" + - "UGX" + - "USD" + - "UYU" + - "UZS" + - "VEF" + - "VND" + - "VUV" + - "WST" + - "XAF" + - "XCD" + - "XDR" + - "XOF" + - "XPF" + - "YER" + - "ZAR" + - "ZMW" + - "ZWD" + - "BTC" + quantity: + type: "number" + itemDetails: type: "string" - isBlockChange: - type: "boolean" - isBlockEntitlement: - type: "boolean" - isBlockBilling: - type: "boolean" - effectiveDate: + catalogEffectiveDate: type: "string" format: "date-time" - type: - type: "string" - enum: - - "SUBSCRIPTION" - - "SUBSCRIPTION_BUNDLE" - - "ACCOUNT" - auditLogs: + childItems: type: "array" items: - $ref: "#/definitions/AuditLog" - PaymentMethod: - type: "object" - properties: - paymentMethodId: - type: "string" - format: "uuid" - externalKey: - type: "string" - accountId: - type: "string" - format: "uuid" - isDefault: - type: "boolean" - pluginName: - type: "string" - pluginInfo: - $ref: "#/definitions/PaymentMethodPluginDetail" + $ref: "#/definitions/InvoiceItem" auditLogs: type: "array" items: $ref: "#/definitions/AuditLog" - PaymentMethodPluginDetail: + InvoicePayment: type: "object" properties: - externalPaymentMethodId: + targetInvoiceId: type: "string" - isDefaultPaymentMethod: - type: "boolean" - properties: - type: "array" - items: - $ref: "#/definitions/PluginProperty" - Payment: - type: "object" - properties: + format: "uuid" accountId: type: "string" format: "uuid" @@ -13366,13 +13216,43 @@ definitions: type: "array" items: $ref: "#/definitions/AuditLog" - Invoice: + PaymentAttempt: type: "object" properties: + accountId: + type: "string" + format: "uuid" + paymentMethodId: + type: "string" + format: "uuid" + paymentExternalKey: + type: "string" + transactionId: + type: "string" + format: "uuid" + transactionExternalKey: + type: "string" + transactionType: + type: "string" + enum: + - "AUTHORIZE" + - "CAPTURE" + - "CHARGEBACK" + - "CREDIT" + - "PURCHASE" + - "REFUND" + - "VOID" + effectiveDate: + type: "string" + format: "date-time" + stateName: + type: "string" amount: type: "number" + description: "Transaction amount, required except for void operations" currency: type: "string" + description: "Amount currency (account currency unless specified)" enum: - "AED" - "AFN" @@ -13539,128 +13419,46 @@ definitions: - "ZMW" - "ZWD" - "BTC" - status: - type: "string" - enum: - - "DRAFT" - - "COMMITTED" - - "VOID" - creditAdj: - type: "number" - refundAdj: - type: "number" - invoiceId: - type: "string" - format: "uuid" - invoiceDate: - type: "string" - format: "date" - targetDate: - type: "string" - format: "date" - invoiceNumber: - type: "string" - balance: - type: "number" - accountId: - type: "string" - format: "uuid" - bundleKeys: + pluginName: type: "string" - credits: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" - items: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" - trackingIds: + pluginProperties: type: "array" items: - type: "string" - isParentInvoice: - type: "boolean" - parentInvoiceId: - type: "string" - format: "uuid" - parentAccountId: - type: "string" - format: "uuid" + $ref: "#/definitions/PluginProperty" auditLogs: type: "array" items: $ref: "#/definitions/AuditLog" - InvoiceItem: + PaymentTransaction: type: "object" - required: - - "accountId" - - "invoiceItemId" properties: - invoiceItemId: - type: "string" - format: "uuid" - invoiceId: - type: "string" - format: "uuid" - linkedInvoiceItemId: - type: "string" - format: "uuid" - accountId: - type: "string" - format: "uuid" - childAccountId: + transactionId: type: "string" format: "uuid" - bundleId: + transactionExternalKey: type: "string" - format: "uuid" - subscriptionId: + paymentId: type: "string" format: "uuid" - productName: - type: "string" - planName: - type: "string" - phaseName: - type: "string" - usageName: - type: "string" - prettyProductName: - type: "string" - prettyPlanName: - type: "string" - prettyPhaseName: - type: "string" - prettyUsageName: + description: "Associated payment id, required when notifying state transitions" + paymentExternalKey: type: "string" - itemType: + transactionType: type: "string" enum: - - "EXTERNAL_CHARGE" - - "FIXED" - - "RECURRING" - - "REPAIR_ADJ" - - "CBA_ADJ" - - "CREDIT_ADJ" - - "ITEM_ADJ" - - "USAGE" - - "TAX" - - "PARENT_SUMMARY" - description: - type: "string" - startDate: - type: "string" - format: "date" - endDate: - type: "string" - format: "date" + - "AUTHORIZE" + - "CAPTURE" + - "CHARGEBACK" + - "CREDIT" + - "PURCHASE" + - "REFUND" + - "VOID" amount: type: "number" - rate: - type: "number" + description: "Transaction amount, required except for void operations" currency: type: "string" + description: "Amount currency (account currency unless specified)" enum: - "AED" - "AFN" @@ -13820,362 +13618,19 @@ definitions: - "XAF" - "XCD" - "XDR" - - "XOF" - - "XPF" - - "YER" - - "ZAR" - - "ZMW" - - "ZWD" - - "BTC" - quantity: - type: "number" - itemDetails: - type: "string" - catalogEffectiveDate: - type: "string" - format: "date-time" - childItems: - type: "array" - items: - $ref: "#/definitions/InvoiceItem" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - BlockPrice: - type: "object" - properties: - unitName: - type: "string" - size: - type: "number" - price: - type: "number" - max: - type: "number" - Bundle: - type: "object" - required: - - "accountId" - properties: - accountId: - type: "string" - format: "uuid" - bundleId: - type: "string" - format: "uuid" - externalKey: - type: "string" - subscriptions: - type: "array" - items: - $ref: "#/definitions/Subscription" - timeline: - $ref: "#/definitions/BundleTimeline" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - BundleTimeline: - type: "object" - properties: - accountId: - type: "string" - format: "uuid" - bundleId: - type: "string" - format: "uuid" - externalKey: - type: "string" - events: - type: "array" - items: - $ref: "#/definitions/EventSubscription" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - EventSubscription: - type: "object" - properties: - eventId: - type: "string" - format: "uuid" - billingPeriod: - type: "string" - enum: - - "DAILY" - - "WEEKLY" - - "BIWEEKLY" - - "THIRTY_DAYS" - - "THIRTY_ONE_DAYS" - - "SIXTY_DAYS" - - "NINETY_DAYS" - - "MONTHLY" - - "BIMESTRIAL" - - "QUARTERLY" - - "TRIANNUAL" - - "BIANNUAL" - - "ANNUAL" - - "SESQUIENNIAL" - - "BIENNIAL" - - "TRIENNIAL" - - "NO_BILLING_PERIOD" - effectiveDate: - type: "string" - format: "date-time" - catalogEffectiveDate: - type: "string" - format: "date-time" - plan: - type: "string" - product: - type: "string" - priceList: - type: "string" - eventType: - type: "string" - enum: - - "START_ENTITLEMENT" - - "START_BILLING" - - "PAUSE_ENTITLEMENT" - - "PAUSE_BILLING" - - "RESUME_ENTITLEMENT" - - "RESUME_BILLING" - - "PHASE" - - "CHANGE" - - "STOP_ENTITLEMENT" - - "STOP_BILLING" - - "SERVICE_STATE_CHANGE" - isBlockedBilling: - type: "boolean" - isBlockedEntitlement: - type: "boolean" - serviceName: - type: "string" - serviceStateName: - type: "string" - phase: - type: "string" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - PhasePrice: - type: "object" - properties: - planName: - type: "string" - phaseName: - type: "string" - phaseType: - type: "string" - fixedPrice: - type: "number" - recurringPrice: - type: "number" - usagePrices: - type: "array" - items: - $ref: "#/definitions/UsagePrice" - Subscription: - type: "object" - required: - - "billingPeriod" - - "planName" - - "priceList" - - "productName" - properties: - accountId: - type: "string" - format: "uuid" - bundleId: - type: "string" - format: "uuid" - bundleExternalKey: - type: "string" - subscriptionId: - type: "string" - format: "uuid" - externalKey: - type: "string" - startDate: - type: "string" - format: "date-time" - productName: - type: "string" - productCategory: - type: "string" - enum: - - "BASE" - - "ADD_ON" - - "STANDALONE" - billingPeriod: - type: "string" - enum: - - "DAILY" - - "WEEKLY" - - "BIWEEKLY" - - "THIRTY_DAYS" - - "THIRTY_ONE_DAYS" - - "SIXTY_DAYS" - - "NINETY_DAYS" - - "MONTHLY" - - "BIMESTRIAL" - - "QUARTERLY" - - "TRIANNUAL" - - "BIANNUAL" - - "ANNUAL" - - "SESQUIENNIAL" - - "BIENNIAL" - - "TRIENNIAL" - - "NO_BILLING_PERIOD" - phaseType: - type: "string" - enum: - - "TRIAL" - - "DISCOUNT" - - "FIXEDTERM" - - "EVERGREEN" - priceList: - type: "string" - planName: - type: "string" - state: - type: "string" - enum: - - "PENDING" - - "ACTIVE" - - "BLOCKED" - - "CANCELLED" - - "EXPIRED" - sourceType: - type: "string" - enum: - - "NATIVE" - - "MIGRATED" - - "TRANSFERRED" - cancelledDate: - type: "string" - format: "date-time" - chargedThroughDate: - type: "string" - format: "date" - billingStartDate: - type: "string" - format: "date-time" - billingEndDate: + - "XOF" + - "XPF" + - "YER" + - "ZAR" + - "ZMW" + - "ZWD" + - "BTC" + effectiveDate: type: "string" format: "date-time" - billCycleDayLocal: - type: "integer" - format: "int32" - quantity: - type: "integer" - format: "int32" - events: - type: "array" - items: - $ref: "#/definitions/EventSubscription" - priceOverrides: - type: "array" - items: - $ref: "#/definitions/PhasePrice" - prices: - type: "array" - items: - $ref: "#/definitions/PhasePrice" - auditLogs: - type: "array" - items: - $ref: "#/definitions/AuditLog" - TierPrice: - type: "object" - properties: - blockPrices: - type: "array" - items: - $ref: "#/definitions/BlockPrice" - UsagePrice: - type: "object" - properties: - usageName: - type: "string" - usageType: - type: "string" - enum: - - "CAPACITY" - - "CONSUMABLE" - billingMode: - type: "string" - enum: - - "IN_ADVANCE" - - "IN_ARREAR" - tierBlockPolicy: - type: "string" - enum: - - "ALL_TIERS" - - "TOP_TIER" - tierPrices: - type: "array" - items: - $ref: "#/definitions/TierPrice" - AccountTimeline: - type: "object" - properties: - account: - $ref: "#/definitions/Account" - bundles: - type: "array" - items: - $ref: "#/definitions/Bundle" - invoices: - type: "array" - items: - $ref: "#/definitions/Invoice" - payments: - type: "array" - items: - $ref: "#/definitions/InvoicePayment" - OverdueState: - type: "object" - properties: - name: - type: "string" - externalMessage: - type: "string" - isDisableEntitlementAndChangesBlocked: - type: "boolean" - isBlockChanges: - type: "boolean" - isClearState: - type: "boolean" - reevaluationIntervalDays: - type: "integer" - format: "int32" - AdminPayment: - type: "object" - properties: - lastSuccessPaymentState: - type: "string" - currentPaymentStateName: - type: "string" - transactionStatus: - type: "string" - SimplePlan: - type: "object" - properties: - planId: - type: "string" - productName: - type: "string" - productCategory: - type: "string" - enum: - - "BASE" - - "ADD_ON" - - "STANDALONE" - currency: + processedAmount: + type: "number" + processedCurrency: type: "string" enum: - "AED" @@ -14343,88 +13798,122 @@ definitions: - "ZMW" - "ZWD" - "BTC" - amount: - type: "number" - billingPeriod: + status: type: "string" + description: "Transaction status, required for state change notifications" enum: - - "DAILY" - - "WEEKLY" - - "BIWEEKLY" - - "THIRTY_DAYS" - - "THIRTY_ONE_DAYS" - - "SIXTY_DAYS" - - "NINETY_DAYS" - - "MONTHLY" - - "BIMESTRIAL" - - "QUARTERLY" - - "TRIANNUAL" - - "BIANNUAL" - - "ANNUAL" - - "SESQUIENNIAL" - - "BIENNIAL" - - "TRIENNIAL" - - "NO_BILLING_PERIOD" - trialLength: - type: "integer" - format: "int32" - trialTimeUnit: + - "SUCCESS" + - "UNKNOWN" + - "PENDING" + - "PAYMENT_FAILURE" + - "PLUGIN_FAILURE" + - "PAYMENT_SYSTEM_OFF" + gatewayErrorCode: type: "string" - enum: - - "DAYS" - - "WEEKS" - - "MONTHS" - - "YEARS" - - "UNLIMITED" - availableBaseProducts: + gatewayErrorMsg: + type: "string" + firstPaymentReferenceId: + type: "string" + secondPaymentReferenceId: + type: "string" + properties: type: "array" items: - type: "string" - Duration: + $ref: "#/definitions/PluginProperty" + auditLogs: + type: "array" + items: + $ref: "#/definitions/AuditLog" + PluginProperty: type: "object" properties: - unit: + key: type: "string" - enum: - - "DAYS" - - "WEEKS" - - "MONTHS" - - "YEARS" - - "UNLIMITED" - number: - type: "integer" - format: "int32" - Limit: + value: + type: "string" + isUpdatable: + type: "boolean" + CustomField: type: "object" + required: + - "name" + - "value" properties: - unit: + customFieldId: type: "string" - max: + format: "uuid" + objectId: type: "string" - min: + format: "uuid" + objectType: type: "string" - Phase: - type: "object" - properties: - type: + enum: + - "ACCOUNT" + - "ACCOUNT_EMAIL" + - "BLOCKING_STATES" + - "BUNDLE" + - "CUSTOM_FIELD" + - "INVOICE" + - "PAYMENT" + - "TRANSACTION" + - "INVOICE_ITEM" + - "INVOICE_PAYMENT" + - "SUBSCRIPTION" + - "SUBSCRIPTION_EVENT" + - "SERVICE_BROADCAST" + - "PAYMENT_ATTEMPT" + - "PAYMENT_METHOD" + - "TAG" + - "TAG_DEFINITION" + - "TENANT" + - "TENANT_KVS" + name: type: "string" - prices: - type: "array" - items: - $ref: "#/definitions/Price" - fixedPrices: - type: "array" - items: - $ref: "#/definitions/Price" - duration: - $ref: "#/definitions/Duration" - usages: + value: + type: "string" + auditLogs: type: "array" items: - $ref: "#/definitions/Usage" - Price: + $ref: "#/definitions/AuditLog" + OverdueState: + type: "object" + properties: + name: + type: "string" + externalMessage: + type: "string" + isDisableEntitlementAndChangesBlocked: + type: "boolean" + isBlockChanges: + type: "boolean" + isClearState: + type: "boolean" + reevaluationIntervalDays: + type: "integer" + format: "int32" + Payment: type: "object" properties: + accountId: + type: "string" + format: "uuid" + paymentId: + type: "string" + format: "uuid" + paymentNumber: + type: "string" + paymentExternalKey: + type: "string" + authAmount: + type: "number" + capturedAmount: + type: "number" + purchasedAmount: + type: "number" + refundedAmount: + type: "number" + creditedAmount: + type: "number" currency: type: "string" enum: @@ -14593,115 +14082,91 @@ definitions: - "ZMW" - "ZWD" - "BTC" - value: - type: "number" - Tier: - type: "object" - properties: - limits: - type: "array" - items: - $ref: "#/definitions/Limit" - fixedPrice: + paymentMethodId: + type: "string" + format: "uuid" + transactions: type: "array" items: - $ref: "#/definitions/Price" - recurringPrice: + $ref: "#/definitions/PaymentTransaction" + paymentAttempts: type: "array" items: - $ref: "#/definitions/Price" - blocks: + $ref: "#/definitions/PaymentAttempt" + auditLogs: type: "array" items: - $ref: "#/definitions/TieredBlock" - TieredBlock: + $ref: "#/definitions/AuditLog" + PaymentMethod: type: "object" properties: - unit: + paymentMethodId: type: "string" - size: + format: "uuid" + externalKey: type: "string" - max: + accountId: type: "string" - prices: + format: "uuid" + isDefault: + type: "boolean" + pluginName: + type: "string" + pluginInfo: + $ref: "#/definitions/PaymentMethodPluginDetail" + auditLogs: type: "array" items: - $ref: "#/definitions/Price" - Usage: + $ref: "#/definitions/AuditLog" + PaymentMethodPluginDetail: type: "object" properties: - billingPeriod: + externalPaymentMethodId: type: "string" - tiers: + isDefaultPaymentMethod: + type: "boolean" + properties: type: "array" items: - $ref: "#/definitions/Tier" - Plan: + $ref: "#/definitions/PluginProperty" + BlockingState: type: "object" properties: - name: + blockedId: type: "string" - prettyName: + format: "uuid" + stateName: type: "string" - recurringBillingMode: + service: type: "string" - enum: - - "IN_ADVANCE" - - "IN_ARREAR" - billingPeriod: + isBlockChange: + type: "boolean" + isBlockEntitlement: + type: "boolean" + isBlockBilling: + type: "boolean" + effectiveDate: + type: "string" + format: "date-time" + type: type: "string" enum: - - "DAILY" - - "WEEKLY" - - "BIWEEKLY" - - "THIRTY_DAYS" - - "THIRTY_ONE_DAYS" - - "SIXTY_DAYS" - - "NINETY_DAYS" - - "MONTHLY" - - "BIMESTRIAL" - - "QUARTERLY" - - "TRIANNUAL" - - "BIANNUAL" - - "ANNUAL" - - "SESQUIENNIAL" - - "BIENNIAL" - - "TRIENNIAL" - - "NO_BILLING_PERIOD" - phases: + - "SUBSCRIPTION" + - "SUBSCRIPTION_BUNDLE" + - "ACCOUNT" + auditLogs: type: "array" items: - $ref: "#/definitions/Phase" - Product: + $ref: "#/definitions/AuditLog" + AdminPayment: type: "object" properties: - type: - type: "string" - name: + lastSuccessPaymentState: type: "string" - prettyName: + currentPaymentStateName: type: "string" - plans: - type: "array" - items: - $ref: "#/definitions/Plan" - included: - type: "array" - items: - type: "string" - available: - type: "array" - items: - type: "string" - PriceList: - type: "object" - properties: - name: + transactionStatus: type: "string" - plans: - type: "array" - items: - type: "string" PlanDetail: type: "object" properties: @@ -14735,6 +14200,179 @@ definitions: type: "array" items: $ref: "#/definitions/Price" + Price: + type: "object" + properties: + currency: + type: "string" + enum: + - "AED" + - "AFN" + - "ALL" + - "AMD" + - "ANG" + - "AOA" + - "ARS" + - "AUD" + - "AWG" + - "AZN" + - "BAM" + - "BBD" + - "BDT" + - "BGN" + - "BHD" + - "BIF" + - "BMD" + - "BND" + - "BOB" + - "BRL" + - "BSD" + - "BTN" + - "BWP" + - "BYR" + - "BZD" + - "CAD" + - "CDF" + - "CHF" + - "CLP" + - "CNY" + - "COP" + - "CRC" + - "CUC" + - "CUP" + - "CVE" + - "CZK" + - "DJF" + - "DKK" + - "DOP" + - "DZD" + - "EGP" + - "ERN" + - "ETB" + - "EUR" + - "FJD" + - "FKP" + - "GBP" + - "GEL" + - "GGP" + - "GHS" + - "GIP" + - "GMD" + - "GNF" + - "GTQ" + - "GYD" + - "HKD" + - "HNL" + - "HRK" + - "HTG" + - "HUF" + - "IDR" + - "ILS" + - "IMP" + - "INR" + - "IQD" + - "IRR" + - "ISK" + - "JEP" + - "JMD" + - "JOD" + - "JPY" + - "KES" + - "KGS" + - "KHR" + - "KMF" + - "KPW" + - "KRW" + - "KWD" + - "KYD" + - "KZT" + - "LAK" + - "LBP" + - "LKR" + - "LRD" + - "LSL" + - "LTL" + - "LVL" + - "LYD" + - "MAD" + - "MDL" + - "MGA" + - "MKD" + - "MMK" + - "MNT" + - "MOP" + - "MRO" + - "MUR" + - "MVR" + - "MWK" + - "MXN" + - "MYR" + - "MZN" + - "NAD" + - "NGN" + - "NIO" + - "NOK" + - "NPR" + - "NZD" + - "OMR" + - "PAB" + - "PEN" + - "PGK" + - "PHP" + - "PKR" + - "PLN" + - "PYG" + - "QAR" + - "RON" + - "RSD" + - "RUB" + - "RWF" + - "SAR" + - "SBD" + - "SCR" + - "SDG" + - "SEK" + - "SGD" + - "SHP" + - "SLL" + - "SOS" + - "SPL" + - "SRD" + - "STD" + - "SVC" + - "SYP" + - "SZL" + - "THB" + - "TJS" + - "TMT" + - "TND" + - "TOP" + - "TRY" + - "TTD" + - "TVD" + - "TWD" + - "TZS" + - "UAH" + - "UGX" + - "USD" + - "UYU" + - "UZS" + - "VEF" + - "VND" + - "VUV" + - "WST" + - "XAF" + - "XCD" + - "XDR" + - "XOF" + - "XPF" + - "YER" + - "ZAR" + - "ZMW" + - "ZWD" + - "BTC" + value: + type: "number" Catalog: type: "object" properties: @@ -14925,25 +14563,392 @@ definitions: type: "array" items: $ref: "#/definitions/PriceList" + Duration: + type: "object" + properties: + unit: + type: "string" + enum: + - "DAYS" + - "WEEKS" + - "MONTHS" + - "YEARS" + - "UNLIMITED" + number: + type: "integer" + format: "int32" + Limit: + type: "object" + properties: + unit: + type: "string" + max: + type: "string" + min: + type: "string" + Phase: + type: "object" + properties: + type: + type: "string" + prices: + type: "array" + items: + $ref: "#/definitions/Price" + fixedPrices: + type: "array" + items: + $ref: "#/definitions/Price" + duration: + $ref: "#/definitions/Duration" + usages: + type: "array" + items: + $ref: "#/definitions/Usage" + Plan: + type: "object" + properties: + name: + type: "string" + prettyName: + type: "string" + recurringBillingMode: + type: "string" + enum: + - "IN_ADVANCE" + - "IN_ARREAR" + billingPeriod: + type: "string" + enum: + - "DAILY" + - "WEEKLY" + - "BIWEEKLY" + - "THIRTY_DAYS" + - "THIRTY_ONE_DAYS" + - "SIXTY_DAYS" + - "NINETY_DAYS" + - "MONTHLY" + - "BIMESTRIAL" + - "QUARTERLY" + - "TRIANNUAL" + - "BIANNUAL" + - "ANNUAL" + - "SESQUIENNIAL" + - "BIENNIAL" + - "TRIENNIAL" + - "NO_BILLING_PERIOD" + phases: + type: "array" + items: + $ref: "#/definitions/Phase" + PriceList: + type: "object" + properties: + name: + type: "string" + plans: + type: "array" + items: + type: "string" + Product: + type: "object" + properties: + type: + type: "string" + name: + type: "string" + prettyName: + type: "string" + plans: + type: "array" + items: + $ref: "#/definitions/Plan" + included: + type: "array" + items: + type: "string" + available: + type: "array" + items: + type: "string" + Tier: + type: "object" + properties: + limits: + type: "array" + items: + $ref: "#/definitions/Limit" + fixedPrice: + type: "array" + items: + $ref: "#/definitions/Price" + recurringPrice: + type: "array" + items: + $ref: "#/definitions/Price" + blocks: + type: "array" + items: + $ref: "#/definitions/TieredBlock" + TieredBlock: + type: "object" + properties: + unit: + type: "string" + size: + type: "string" + max: + type: "string" + prices: + type: "array" + items: + $ref: "#/definitions/Price" Unit: type: "object" properties: name: type: "string" - prettyName: + prettyName: + type: "string" + Usage: + type: "object" + properties: + billingPeriod: + type: "string" + tiers: + type: "array" + items: + $ref: "#/definitions/Tier" + CatalogValidation: + type: "object" + properties: + catalogValidationErrors: + type: "array" + items: + $ref: "#/definitions/CatalogValidationError" + CatalogValidationError: + type: "object" + properties: + errorDescription: + type: "string" + SimplePlan: + type: "object" + properties: + planId: + type: "string" + productName: + type: "string" + productCategory: + type: "string" + enum: + - "BASE" + - "ADD_ON" + - "STANDALONE" + currency: + type: "string" + enum: + - "AED" + - "AFN" + - "ALL" + - "AMD" + - "ANG" + - "AOA" + - "ARS" + - "AUD" + - "AWG" + - "AZN" + - "BAM" + - "BBD" + - "BDT" + - "BGN" + - "BHD" + - "BIF" + - "BMD" + - "BND" + - "BOB" + - "BRL" + - "BSD" + - "BTN" + - "BWP" + - "BYR" + - "BZD" + - "CAD" + - "CDF" + - "CHF" + - "CLP" + - "CNY" + - "COP" + - "CRC" + - "CUC" + - "CUP" + - "CVE" + - "CZK" + - "DJF" + - "DKK" + - "DOP" + - "DZD" + - "EGP" + - "ERN" + - "ETB" + - "EUR" + - "FJD" + - "FKP" + - "GBP" + - "GEL" + - "GGP" + - "GHS" + - "GIP" + - "GMD" + - "GNF" + - "GTQ" + - "GYD" + - "HKD" + - "HNL" + - "HRK" + - "HTG" + - "HUF" + - "IDR" + - "ILS" + - "IMP" + - "INR" + - "IQD" + - "IRR" + - "ISK" + - "JEP" + - "JMD" + - "JOD" + - "JPY" + - "KES" + - "KGS" + - "KHR" + - "KMF" + - "KPW" + - "KRW" + - "KWD" + - "KYD" + - "KZT" + - "LAK" + - "LBP" + - "LKR" + - "LRD" + - "LSL" + - "LTL" + - "LVL" + - "LYD" + - "MAD" + - "MDL" + - "MGA" + - "MKD" + - "MMK" + - "MNT" + - "MOP" + - "MRO" + - "MUR" + - "MVR" + - "MWK" + - "MXN" + - "MYR" + - "MZN" + - "NAD" + - "NGN" + - "NIO" + - "NOK" + - "NPR" + - "NZD" + - "OMR" + - "PAB" + - "PEN" + - "PGK" + - "PHP" + - "PKR" + - "PLN" + - "PYG" + - "QAR" + - "RON" + - "RSD" + - "RUB" + - "RWF" + - "SAR" + - "SBD" + - "SCR" + - "SDG" + - "SEK" + - "SGD" + - "SHP" + - "SLL" + - "SOS" + - "SPL" + - "SRD" + - "STD" + - "SVC" + - "SYP" + - "SZL" + - "THB" + - "TJS" + - "TMT" + - "TND" + - "TOP" + - "TRY" + - "TTD" + - "TVD" + - "TWD" + - "TZS" + - "UAH" + - "UGX" + - "USD" + - "UYU" + - "UZS" + - "VEF" + - "VND" + - "VUV" + - "WST" + - "XAF" + - "XCD" + - "XDR" + - "XOF" + - "XPF" + - "YER" + - "ZAR" + - "ZMW" + - "ZWD" + - "BTC" + amount: + type: "number" + billingPeriod: + type: "string" + enum: + - "DAILY" + - "WEEKLY" + - "BIWEEKLY" + - "THIRTY_DAYS" + - "THIRTY_ONE_DAYS" + - "SIXTY_DAYS" + - "NINETY_DAYS" + - "MONTHLY" + - "BIMESTRIAL" + - "QUARTERLY" + - "TRIANNUAL" + - "BIANNUAL" + - "ANNUAL" + - "SESQUIENNIAL" + - "BIENNIAL" + - "TRIENNIAL" + - "NO_BILLING_PERIOD" + trialLength: + type: "integer" + format: "int32" + trialTimeUnit: type: "string" - CatalogValidation: - type: "object" - properties: - catalogValidationErrors: + enum: + - "DAYS" + - "WEEKS" + - "MONTHS" + - "YEARS" + - "UNLIMITED" + availableBaseProducts: type: "array" items: - $ref: "#/definitions/CatalogValidationError" - CatalogValidationError: - type: "object" - properties: - errorDescription: - type: "string" + type: "string" InvoicePaymentTransaction: type: "object" properties: @@ -15427,6 +15432,24 @@ definitions: $ref: "#/definitions/PhasePrice" planName: type: "string" + NodeCommand: + type: "object" + properties: + isSystemCommandType: + type: "boolean" + nodeCommandType: + type: "string" + nodeCommandProperties: + type: "array" + items: + $ref: "#/definitions/NodeCommandProperty" + NodeCommandProperty: + type: "object" + properties: + key: + type: "string" + value: + type: "object" NodeInfo: type: "object" properties: @@ -15479,24 +15502,6 @@ definitions: type: "string" registrationName: type: "string" - NodeCommand: - type: "object" - properties: - isSystemCommandType: - type: "boolean" - nodeCommandType: - type: "string" - nodeCommandProperties: - type: "array" - items: - $ref: "#/definitions/NodeCommandProperty" - NodeCommandProperty: - type: "object" - properties: - key: - type: "string" - value: - type: "object" Overdue: type: "object" properties: @@ -15602,13 +15607,6 @@ definitions: type: "array" items: $ref: "#/definitions/AuditLog" - HostedPaymentPageFields: - type: "object" - properties: - formFields: - type: "array" - items: - $ref: "#/definitions/PluginProperty" ComboHostedPaymentPage: type: "object" properties: @@ -15626,6 +15624,13 @@ definitions: type: "array" items: $ref: "#/definitions/AuditLog" + HostedPaymentPageFields: + type: "object" + properties: + formFields: + type: "array" + items: + $ref: "#/definitions/PluginProperty" ComboPaymentTransaction: type: "object" properties: diff --git a/pom.xml b/pom.xml index 4355450..dbcf21c 100644 --- a/pom.xml +++ b/pom.xml @@ -125,8 +125,8 @@ - - + + MANIFEST.MF diff --git a/src/main/java/org/killbill/billing/client/api/gen/CreditApi.java b/src/main/java/org/killbill/billing/client/api/gen/CreditApi.java index c7334ee..110c17b 100644 --- a/src/main/java/org/killbill/billing/client/api/gen/CreditApi.java +++ b/src/main/java/org/killbill/billing/client/api/gen/CreditApi.java @@ -23,6 +23,7 @@ import java.util.Objects; import org.killbill.billing.client.model.gen.InvoiceItem; +import org.joda.time.LocalDate; import java.util.UUID; import org.killbill.billing.client.model.InvoiceItems; import java.util.List; @@ -56,16 +57,19 @@ public CreditApi(final KillBillHttpClient httpClient) { this.httpClient = httpClient; } - public InvoiceItems createCredits(final InvoiceItems body, final Map pluginProperty, final RequestOptions inputOptions) throws KillBillClientException { - return createCredits(body, Boolean.valueOf(false), pluginProperty, inputOptions); + public InvoiceItems createCredits(final InvoiceItems body, final LocalDate requestedDate, final Map pluginProperty, final RequestOptions inputOptions) throws KillBillClientException { + return createCredits(body, requestedDate, Boolean.valueOf(false), pluginProperty, inputOptions); } - public InvoiceItems createCredits(final InvoiceItems body, final Boolean autoCommit, final Map pluginProperty, final RequestOptions inputOptions) throws KillBillClientException { + public InvoiceItems createCredits(final InvoiceItems body, final LocalDate requestedDate, final Boolean autoCommit, final Map pluginProperty, final RequestOptions inputOptions) throws KillBillClientException { Preconditions.checkNotNull(body, "Missing the required parameter 'body' when calling createCredits"); final String uri = "/1.0/kb/credits"; final Multimap queryParams = new TreeMapSetMultimap<>(inputOptions.getQueryParams()); + if (requestedDate != null) { + queryParams.put("requestedDate", String.valueOf(requestedDate)); + } if (autoCommit != null) { queryParams.put("autoCommit", String.valueOf(autoCommit)); } diff --git a/src/main/java/org/killbill/billing/client/model/gen/EventSubscription.java b/src/main/java/org/killbill/billing/client/model/gen/EventSubscription.java index 440cada..7b67e66 100644 --- a/src/main/java/org/killbill/billing/client/model/gen/EventSubscription.java +++ b/src/main/java/org/killbill/billing/client/model/gen/EventSubscription.java @@ -46,7 +46,7 @@ public class EventSubscription extends KillBillObject { private BillingPeriod billingPeriod = null; private DateTime effectiveDate = null; - + private DateTime catalogEffectiveDate = null; private String plan = null; @@ -131,15 +131,16 @@ public DateTime getEffectiveDate() { return effectiveDate; } - public DateTime getCatalogEffectiveDate() { - return catalogEffectiveDate; - } + public EventSubscription setCatalogEffectiveDate(final DateTime catalogEffectiveDate) { + this.catalogEffectiveDate = catalogEffectiveDate; + return this; + } - public void setCatalogEffectiveDate(DateTime catalogEffectiveDate) { - this.catalogEffectiveDate = catalogEffectiveDate; - } + public DateTime getCatalogEffectiveDate() { + return catalogEffectiveDate; + } - public EventSubscription setPlan(final String plan) { + public EventSubscription setPlan(final String plan) { this.plan = plan; return this; }