{
  "type": "object",
  "properties": {
    "amount_qar": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000000,
      "description": "Amount in QAR (decimals allowed), e.g. 10. Minimum 1."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤200 chars)"
    },
    "customer_email": {
      "type": "string",
      "description": "Buyer email (required by Tap Payments; the receipt goes there)."
    },
    "reference_id": {
      "type": "string",
      "description": "Your unique order reference (≤40 chars). Auto-generated if omitted."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after payment."
    }
  },
  "required": [
    "amount_qar",
    "description",
    "customer_email"
  ]
}

{
  "type": "object",
  "properties": {
    "charge_id": {
      "type": "string",
      "description": "The charge_id (chg_...) returned by create_payment_link"
    }
  },
  "required": [
    "charge_id"
  ]
}

{
  "type": "object",
  "properties": {
    "charge_id": {
      "type": "string",
      "description": "The charge_id of the paid payment (same id used by query_payment_status)"
    },
    "amount": {
      "type": "number",
      "description": "Optional partial-refund amount in the local currency major unit. Omit for a full refund."
    }
  },
  "required": [
    "charge_id"
  ]
}