{
  "type": "object",
  "properties": {
    "amount_php": {
      "type": "number",
      "minimum": 20,
      "maximum": 10000000,
      "description": "Amount in PHP pesos (e.g. 499.50; converted to centavos internally). Minimum ₱20."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤255 chars)"
    },
    "payment_method_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Payment methods to offer. Default [\"card\",\"gcash\"]. Common values: card, gcash, paymaya, grab_pay, dob, dob_ubp, brankas_bdo, brankas_landbank, brankas_metrobank, atome, billease, qrph. Only methods activated on the merchant PayMongo account are accepted."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after successful payment."
    },
    "cancel_url": {
      "type": "string",
      "description": "Optional https URL if the buyer cancels."
    },
    "provider": {
      "type": "string",
      "enum": [
        "paymongo",
        "xendit"
      ],
      "description": "Which gateway. Omit to auto-select: Xendit when x-xendit-secret-key header is present, otherwise PayMongo. payment_method_types applies to PayMongo only."
    }
  },
  "required": [
    "amount_php",
    "description"
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id returned by create_payment_link (PayMongo cs_... or Xendit reference)"
    },
    "provider": {
      "type": "string",
      "enum": [
        "paymongo",
        "xendit"
      ],
      "description": "Omit to auto-select by credential headers."
    }
  },
  "required": [
    "session_id"
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id of the paid payment (same id used by query_payment_status)"
    },
    "amount": {
      "type": "number",
      "description": "Optional partial-refund amount in PHP (decimals allowed). Omit for a full refund."
    },
    "provider": {
      "type": "string",
      "enum": [
        "xendit"
      ],
      "description": "Refunds are currently supported on Xendit only."
    }
  },
  "required": [
    "session_id"
  ]
}

{
  "type": "object",
  "properties": {
    "amount_php": {
      "type": "number",
      "minimum": 20,
      "maximum": 10000000,
      "description": "Amount charged PER billing period, in PHP pesos (decimals allowed, e.g. 499.50). Minimum ₱20."
    },
    "period": {
      "type": "string",
      "enum": [
        "monthly",
        "yearly",
        "weekly",
        "daily"
      ],
      "description": "Billing period. Default \"monthly\"."
    },
    "interval": {
      "type": "integer",
      "minimum": 1,
      "description": "Charge every N periods (e.g. period=monthly, interval=1 = every month; interval=3 = every 3 months). Default 1. (Yearly is billed as 12-month intervals; interval multiplies that.)"
    },
    "total_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "description": "Number of billing cycles to charge before the subscription completes (e.g. 12 monthly cycles = one year). Default 12."
    },
    "description": {
      "type": "string",
      "description": "What the subscription is for (shown to the buyer)."
    },
    "customer_name": {
      "type": "string",
      "description": "Optional buyer name (shown on the Xendit hosted page)."
    },
    "customer_email": {
      "type": "string",
      "description": "Optional buyer email (Xendit sends subscription receipts there)."
    },
    "finish_redirect_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after they authorize. Omit to use the Xendit default result screen."
    },
    "order_id": {
      "type": "string",
      "description": "Your unique subscription reference (6-50 chars, letters/digits/-/_/.). Auto-generated if omitted."
    },
    "provider": {
      "type": "string",
      "enum": [
        "xendit"
      ],
      "description": "Subscriptions are supported on Xendit only (send x-xendit-secret-key). PayMongo is not supported."
    }
  },
  "required": [
    "amount_php",
    "description"
  ]
}

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "The subscription_id (payment session ps-..., or a recurring plan repl_...) returned by create_subscription_link / query_subscription"
    },
    "provider": {
      "type": "string",
      "enum": [
        "xendit"
      ],
      "description": "Subscriptions are supported on Xendit only."
    }
  },
  "required": [
    "subscription_id"
  ]
}

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "The recurring_plan_id (repl_...) to cancel — get it from query_subscription once the subscription is active."
    },
    "provider": {
      "type": "string",
      "enum": [
        "xendit"
      ],
      "description": "Subscriptions are supported on Xendit only."
    }
  },
  "required": [
    "subscription_id"
  ]
}