payment-create

InsuranceAuto InsuranceTelematicsEmbedded InsurancePolicy AdministrationClaimsUsage-Based InsuranceInsurtech

Properties

Name	Type	Description
status	object
payment_method_id	string	Payment method id of the payment being created. Must be a UUID.
payment_type	object
premium_type	object
amount	number	The payment amount. Required when `retry_of` is not provided; otherwise forbidden.
description	string	Description of the payment being submitted. Required when `retry_of` is not provided; otherwise forbidden.
payment_date	string	Date the payment was created.
finalized_at	string	Date the payment was finalized. Required when `status` is `failed` or `successful`.
collection_type	object
billing_date	string	Date the payment should be processed.
external_reference	string	Unique external reference of the payment.
retry_of	string	Original payment id of the payment being retried. Must be a UUID.
failure_reason	string	A description of the reason the payment failed. Required if `status` is `failed`, forbidden otherwise.
failure_action	object
failure_code	string	Optional if `status` is `failed`, forbidden otherwise. The failure error code.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "payment-create",
  "type": "object",
  "required": [
    "amount",
    "status",
    "description",
    "payment_type",
    "payment_date",
    "collection_type",
    "payment_method_id"
  ],
  "properties": {
    "status": {
      "$ref": "#/components/schemas/payment-status"
    },
    "payment_method_id": {
      "type": "string",
      "description": "Payment method id of the payment being created. Must be a UUID."
    },
    "payment_type": {
      "$ref": "#/components/schemas/payment-type"
    },
    "premium_type": {
      "$ref": "#/components/schemas/premium-type"
    },
    "amount": {
      "type": "number",
      "description": "The payment amount. Required when `retry_of` is not provided; otherwise forbidden."
    },
    "description": {
      "type": "string",
      "description": "Description of the payment being submitted. Required when `retry_of` is not provided; otherwise forbidden."
    },
    "payment_date": {
      "type": "string",
      "format": "date-time",
      "description": "Date the payment was created."
    },
    "finalized_at": {
      "type": "string",
      "format": "date-time",
      "description": "Date the payment was finalized. Required when `status` is `failed` or `successful`."
    },
    "collection_type": {
      "$ref": "#/components/schemas/collection-type"
    },
    "billing_date": {
      "type": "string",
      "format": "date-time",
      "description": "Date the payment should be processed."
    },
    "external_reference": {
      "type": "string",
      "description": "Unique external reference of the payment."
    },
    "retry_of": {
      "type": "string",
      "description": "Original payment id of the payment being retried. Must be a UUID."
    },
    "failure_reason": {
      "type": "string",
      "description": "A description of the reason the payment failed. Required if `status` is `failed`, forbidden otherwise."
    },
    "failure_action": {
      "$ref": "#/components/schemas/failure-action"
    },
    "failure_code": {
      "type": "string",
      "description": "Optional if `status` is `failed`, forbidden otherwise. The failure error code."
    }
  },
  "example": {
    "status": "successful",
    "description": "Monthly premium",
    "payment_type": "premium",
    "premium_type": "pro_rata",
    "amount": 1800,
    "payment_date": "2022-09-08T00:00:00Z",
    "external_reference": "B23423",
    "collection_type": "debit_order_same_day",
    "finalized_at": "2022-09-08T00:00:00Z",
    "billing_date": "2022-09-08T00:00:00Z"
  }
}

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/payment-create"

All schemas

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

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

Get an API key

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

GitHub Google LinkedIn

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