Bill payments

{
  "channel_id": "3KWPkvN7G0ryWRJbNcBl0bbDmWS",
  "currency": "MZN",
  "low_balance_minor": 50000,
  "updated_at": "2026-10-10T22:14:58.039503731Z"
}

{
  "code": "invalid_request",
  "detail": "no such account",
  "error": {
    "code": "invalid_request",
    "message": "no such account"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "channel_id": "3K4SjgBC4GZKqZAEojB1QDdbYiw",
  "commission": "22.50",
  "currency": "MZN",
  "lines": [
    {
      "amount": "1000.00",
      "bill_payment_id": "3K7sTNTzRrMVuuCSlaWe6IT5tcr",
      "biller": "edm",
      "commission": "15.00",
      "completed_at": "2026-09-12T08:31:05Z",
      "product": "credelec"
    },
    {
      "amount": "500.00",
      "bill_payment_id": "3K2xMacVPsuM57QuDBSLsOiRYpc",
      "biller": "aguas_maputo",
      "commission": "7.50",
      "completed_at": "2026-09-21T18:02:47Z",
      "product": "water"
    }
  ],
  "month": "2026-09",
  "sales": 2,
  "volume": "1500.00"
}

{
  "data": [
    {
      "amount": "250.00",
      "artifacts": [
        {
          "type": "receipt",
          "value": "FK2026101045631213"
        },
        {
          "meta": {
            "krn": "1",
            "sgc": "600123",
            "ti": "1"
          },
          "type": "token",
          "unit_type": "kWh",
          "units": "25.00",
          "value": "****************7957"
        }
      ],
      "attempts": 1,
      "biller": "EDM",
      "biller_name": "EDM",
      "breakdown": {
        "lines": [
          {
            "amount": "250.00",
            "concept": "Unit charge per kWh",
            "price": "10.00",
            "units": "25.00"
          }
        ],
        "unit_type": "kWh",
        "units": "25.00"
      },
      "channel_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "completed_at": "2026-10-10T22:14:58.744497415Z",
      "created_at": "2026-10-10T22:14:58.651626029Z",
      "currency": "MZN",
      "customer_name": "C****** T**** 7***",
      "customer_reference": "01234567890",
      "fee_bearer": "payer",
      "funding": "balance",
      "id": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
      "mode": "test",
      "object": "bill_payment",
      "participants": [
        {
          "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
          "name": "Tenant B",
          "role": "initiating_psp"
        },
        {
          "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
          "name": "Tenant B",
          "role": "from_psp",
          "settlement": "prefunded_balance"
        }
      ],
      "partner_reference": "POS-9",
      "payer_fee": "5.00",
      "product": "CREDELEC",
      "product_version": 1,
      "queries": 0,
      "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
      "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
      "sent_at": "2026-10-10T22:14:58.727064442Z",
      "shape": "metered_prepaid",
      "status": "succeeded",
      "supplier_reference": "FK2026101045631213",
      "total": "255.00"
    }
  ],
  "total": 1
}

{
  "amount": "250.00",
  "artifacts": [
    {
      "type": "receipt",
      "value": "FK2026101045631213"
    },
    {
      "meta": {
        "krn": "1",
        "sgc": "600123",
        "ti": "1"
      },
      "type": "token",
      "unit_type": "kWh",
      "units": "25.00",
      "value": "****************7957"
    }
  ],
  "attempts": 1,
  "biller": "EDM",
  "biller_name": "EDM",
  "breakdown": {
    "lines": [
      {
        "amount": "250.00",
        "concept": "Unit charge per kWh",
        "price": "10.00",
        "units": "25.00"
      }
    ],
    "unit_type": "kWh",
    "units": "25.00"
  },
  "channel_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
  "completed_at": "2026-10-10T22:14:58.744497415Z",
  "created_at": "2026-10-10T22:14:58.651626029Z",
  "currency": "MZN",
  "customer_name": "C****** T**** 7***",
  "customer_reference": "01234567890",
  "fee_bearer": "payer",
  "funding": "balance",
  "id": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
  "mode": "test",
  "object": "bill_payment",
  "participants": [
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "initiating_psp"
    },
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "from_psp",
      "settlement": "prefunded_balance"
    }
  ],
  "partner_reference": "POS-9",
  "payer_fee": "5.00",
  "product": "CREDELEC",
  "product_version": 1,
  "queries": 0,
  "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
  "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
  "sent_at": "2026-10-10T22:14:58.727064442Z",
  "shape": "metered_prepaid",
  "status": "succeeded",
  "supplier_reference": "FK2026101045631213",
  "total": "255.00"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "artifacts": [
    {
      "type": "receipt",
      "value": "FK2026101045631213"
    },
    {
      "meta": {
        "krn": "1",
        "sgc": "600123",
        "ti": "1"
      },
      "type": "token",
      "unit_type": "kWh",
      "units": "25.00",
      "value": "69556183477675547957"
    }
  ]
}

{
  "code": "invalid_request",
  "detail": "a reason is required",
  "error": {
    "code": "invalid_request",
    "message": "a reason is required"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "idempotency_replay_unavailable",
  "detail": "A request with this Idempotency-Key already succeeded. Its response held a secret that is shown once and not kept, so it cannot be replayed: list the resources to find the one it created, and revoke it if its secret was lost.",
  "error": {
    "code": "idempotency_replay_unavailable",
    "message": "A request with this Idempotency-Key already succeeded. Its response held a secret that is shown once and not kept, so it cannot be replayed: list the resources to find the one it created, and revoke it if its secret was lost."
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "approval": {
    "created_at": "2026-10-11T10:02:37Z",
    "id": "3KUYO4KZt1AMD7NPEGgTx2VrIB7",
    "kind": "bill.resolve",
    "payload": "{\"outcome\":\"failed\"}",
    "prepared_by": "8f3c2a7e5b1d4c6a9e0f2b7d4a1c5e83",
    "reason": "EDM confirmed by phone that no token was issued for this request",
    "status": "pending",
    "subject_id": "3KUYJ7FUo4vHy1IKzBbOs5QmDw2",
    "tenant_id": "3KUXV2rGa7hTj4uWkMnAe8CyPi8"
  }
}

{
  "code": "invalid_request",
  "detail": "only a payment in review is resolved by hand (this one is succeeded)",
  "error": {
    "code": "invalid_request",
    "message": "only a payment in review is resolved by hand (this one is succeeded)"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "breaks": 1,
      "breaks_list": [
        {
          "customer_reference": "07011122233",
          "kind": "supplier_only",
          "request_id": "3KUZD4ZOI1PBS7CETVvIM2KGgQ2",
          "supplier_amount_minor": 50000,
          "supplier_reference": "EDM-20261010-559102"
        }
      ],
      "connector": "edm_live",
      "connector_id": "3KUXT4pDy6eRf8sUhJkYc2AwMg6",
      "created_at": "2026-10-11T06:00:41Z",
      "day": "2026-10-10T00:00:00Z",
      "id": "3KUYI4ETn1uGx7HJyAaNr2PlCv1",
      "kulpay_count": 1287,
      "matched": 1286,
      "source": "pull",
      "supplier_count": 1287
    }
  ],
  "total": 1
}

{
  "data": [
    {
      "allow_overpay": false,
      "allow_partial": false,
      "category": "electricity",
      "code": "EDM",
      "country": "MZ",
      "created_at": "2026-03-02T08:15:00Z",
      "id": "3KUXQ43bztiuf9tCMNgbcrYvne3",
      "logo_url": "https://cdn.example.co.mz/billers/edm.png",
      "name": "Electricidade de Moçambique",
      "presentment_modes": [],
      "status": "active",
      "support_email": "apoioexample.co.mz",
      "support_phone": "+258841234567",
      "updated_at": "2026-09-18T10:42:11Z"
    },
    {
      "allow_overpay": false,
      "allow_partial": true,
      "category": "water",
      "code": "AGUAS_MAPUTO",
      "country": "MZ",
      "created_at": "2026-04-11T09:00:00Z",
      "id": "3KUXR1mVq8sLd2tPfGhZa7YwKe4",
      "invoice_expiry_days": 30,
      "name": "Águas da Região de Maputo",
      "presentment_modes": [
        "push",
        "lookup"
      ],
      "remit_account": "000800001234567890157",
      "remit_bank": "BCI",
      "remit_frequency": "daily",
      "status": "active",
      "support_email": "clientesexample.co.mz",
      "tenant_id": "3KUXS7nBw2cQe5rTgHjXb9ZvLf5",
      "updated_at": "2026-10-01T14:20:37Z"
    }
  ],
  "total": 2
}

{
  "allow_overpay": false,
  "allow_partial": false,
  "category": "water",
  "code": "AGUAS",
  "country": "MZ",
  "created_at": "2026-10-10T22:14:59.252334782Z",
  "id": "3KWPlFlovXTX5hJHsBDDV47dyHf",
  "invoice_expiry_days": 30,
  "name": "Águas",
  "presentment_modes": [
    "push"
  ],
  "status": "draft",
  "tenant_id": "3KWPl3PNWBvbCepPhJBUlOXiLUx",
  "updated_at": "2026-10-10T22:14:59.252334782Z"
}

{
  "code": "invalid_request",
  "detail": "category is one of electricity, water, telecom, tv, internet, education, insurance, government, other",
  "error": {
    "code": "invalid_request",
    "message": "category is one of electricity, water, telecom, tv, internet, education, insurance, government, other"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "biller": {
    "allow_overpay": false,
    "allow_partial": false,
    "category": "tv",
    "code": "TVCABO",
    "country": "MZ",
    "created_at": "2026-10-10T22:14:57.786577491Z",
    "id": "3KWPkylzKmRsF6Rq3xef8pjun2x",
    "name": "TV Cabo",
    "presentment_modes": [],
    "status": "active",
    "support_phone": "+258 21 480 500",
    "updated_at": "2026-10-10T22:14:57.920983259Z"
  },
  "products": [
    {
      "allowed_channels": null,
      "amount_rule": "fixed",
      "biller_id": "3KWPkylzKmRsF6Rq3xef8pjun2x",
      "code": "PACOTE",
      "connectors": [
        "3KWPkweeFBr3p9OxYa5dTFjzMCF"
      ],
      "created_at": "2026-10-10T22:14:57.814553026Z",
      "currency": "MZN",
      "denominations": null,
      "enabled": true,
      "fee_bearer": "payer",
      "fee_bps": 0,
      "fee_fixed_minor": 500,
      "fixed_minor": 75000,
      "id": "3KWPkv1wLq7YHJt6Jqg48mMzOKS",
      "lookup_required": false,
      "model": "agent",
      "name": "Pacote",
      "reference_label": "Smartcard",
      "reference_pattern": "^\\d{10}$",
      "shape": "account_topup",
      "supplier_product": "tv",
      "updated_at": "2026-10-10T22:14:57.814553026Z",
      "version": 1
    }
  ]
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "allow_overpay": false,
  "allow_partial": false,
  "category": "water",
  "code": "AGUAS",
  "country": "MZ",
  "created_at": "2026-10-10T22:14:59.252334782Z",
  "id": "3KWPlFlovXTX5hJHsBDDV47dyHf",
  "invoice_expiry_days": 30,
  "name": "Águas",
  "presentment_modes": [
    "push",
    "file"
  ],
  "status": "active",
  "tenant_id": "3KWPl3PNWBvbCepPhJBUlOXiLUx",
  "updated_at": "2026-10-10T22:14:59.846639591Z"
}

{
  "code": "invalid_request",
  "detail": "support_email is not an email address",
  "error": {
    "code": "invalid_request",
    "message": "support_email is not an email address"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "biller": "AGUAS",
  "mode": "live",
  "png_url": "/v1/biller/accounts/CL-001234/qr.png",
  "reference": "CL-0042",
  "svg_url": "/v1/biller/accounts/CL-001234/qr.svg",
  "url": "https://pay.kulpay.co.mz/pay/account/bB9BR1VBUx8fQ0wtMDA0Mg.3oT2Lw9sQe1Zk7mN"
}

{
  "code": "invalid_request",
  "detail": "no product of AGUAS takes CL-****2 as a reference",
  "error": {
    "code": "invalid_request",
    "message": "no product of AGUAS takes CL-****2 as a reference"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invalid_request",
  "detail": "no product of AGUAS takes CL-****2 as a reference",
  "error": {
    "code": "invalid_request",
    "message": "no product of AGUAS takes CL-****2 as a reference"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invalid_request",
  "detail": "no product of AGUAS takes CL-****2 as a reference",
  "error": {
    "code": "invalid_request",
    "message": "no product of AGUAS takes CL-****2 as a reference"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "allowed_channels": null,
  "amount_rule": "fixed",
  "biller_id": "3KWPkylzKmRsF6Rq3xef8pjun2x",
  "code": "PACOTE",
  "connectors": [
    "3KWPkweeFBr3p9OxYa5dTFjzMCF"
  ],
  "created_at": "2026-10-10T22:14:57.814553026Z",
  "currency": "MZN",
  "denominations": null,
  "enabled": true,
  "fee_bearer": "payer",
  "fee_bps": 0,
  "fee_fixed_minor": 500,
  "fixed_minor": 75000,
  "id": "3KWPkv1wLq7YHJt6Jqg48mMzOKS",
  "lookup_required": false,
  "model": "agent",
  "name": "Pacote",
  "reference_label": "Smartcard",
  "reference_pattern": "^\\d{10}$",
  "shape": "account_topup",
  "supplier_product": "tv",
  "updated_at": "2026-10-10T22:14:57.814553026Z",
  "version": 1
}

{
  "code": "invalid_request",
  "detail": "reference_label is required: what the payer enters (meter number, phone number…)",
  "error": {
    "code": "invalid_request",
    "message": "reference_label is required: what the payer enters (meter number, phone number…)"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "fee_bearer_conflict",
  "detail": "the payer bears the fee, so the biller cannot also give a discount: one party pays, never both",
  "error": {
    "code": "fee_bearer_conflict",
    "message": "the payer bears the fee, so the biller cannot also give a discount: one party pays, never both"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "allowed_channels": null,
  "amount_rule": "range",
  "biller_id": "3KUXQ43bztiuf9tCMNgbcrYvne3",
  "code": "CREDELEC",
  "connectors": [
    "3KUXT4pDy6eRf8sUhJkYc2AwMg6"
  ],
  "created_at": "2026-03-02T08:30:00Z",
  "currency": "MZN",
  "denominations": null,
  "enabled": true,
  "fee_bearer": "payer",
  "fee_bps": 150,
  "fee_fixed_minor": 0,
  "fee_max_minor": 10000,
  "fee_min_minor": 500,
  "id": "3KUXU9qFz3gSh1tViLmZd5BxNh7",
  "limit_channel_daily_minor": 50000000,
  "limit_reference_daily_count": 5,
  "lookup_required": true,
  "max_minor": 5000000,
  "min_minor": 5000,
  "model": "principal",
  "name": "Credelec pré-pago",
  "reference_example": "07012345678",
  "reference_label": "Número do contador",
  "reference_pattern": "^[0-9]{11}$",
  "shape": "metered_prepaid",
  "supplier_product": "CREDELEC",
  "updated_at": "2026-10-11T09:12:44Z",
  "version": 4
}

{
  "code": "invalid_request",
  "detail": "fees are non-negative, percentages at most 100%, and fee_min_minor <= fee_max_minor",
  "error": {
    "code": "invalid_request",
    "message": "fees are non-negative, percentages at most 100%, and fee_min_minor <= fee_max_minor"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "fee_bearer_conflict",
  "detail": "the payer bears the fee, so the biller cannot also give a discount: one party pays, never both",
  "error": {
    "code": "fee_bearer_conflict",
    "message": "the payer bears the fee, so the biller cannot also give a discount: one party pays, never both"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "allowed_channels": [
    "3KUXV2rGa7hTj4uWkMnAe8CyPi8",
    "3KUXW5sHb1iUk7vXmNoBf3DzQj9"
  ],
  "amount_rule": "range",
  "biller_id": "3KUXQ43bztiuf9tCMNgbcrYvne3",
  "code": "CREDELEC",
  "connectors": [
    "3KUXT4pDy6eRf8sUhJkYc2AwMg6"
  ],
  "created_at": "2026-03-02T08:30:00Z",
  "currency": "MZN",
  "denominations": null,
  "enabled": true,
  "fee_bearer": "payer",
  "fee_bps": 150,
  "fee_fixed_minor": 0,
  "fee_max_minor": 10000,
  "fee_min_minor": 500,
  "id": "3KUXU9qFz3gSh1tViLmZd5BxNh7",
  "lookup_required": true,
  "max_minor": 5000000,
  "min_minor": 5000,
  "model": "principal",
  "name": "Credelec pré-pago",
  "reference_example": "07012345678",
  "reference_label": "Número do contador",
  "reference_pattern": "^[0-9]{11}$",
  "shape": "metered_prepaid",
  "supplier_product": "CREDELEC",
  "updated_at": "2026-10-11T09:20:03Z",
  "version": 5
}

{
  "code": "invalid_request",
  "detail": "no channel account 3KUXX8tJc4jVm1wYnPpCg6EaRk0",
  "error": {
    "code": "invalid_request",
    "message": "no channel account 3KUXX8tJc4jVm1wYnPpCg6EaRk0"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "biller": "AGUAS",
  "fields": [
    "event",
    "notification_id",
    "payment_id",
    "request_id",
    "mode",
    "biller",
    "biller_name",
    "product",
    "supplier_product",
    "reference",
    "invoice_number",
    "amount",
    "payer_fee",
    "total",
    "currency",
    "amount_minor",
    "total_minor",
    "paid_at",
    "channel_id",
    "channel_name",
    "funding",
    "partner_reference",
    "supplier_reference",
    "receipt_url"
  ],
  "mode": "test",
  "notification": {
    "auth": "hmac",
    "content_type": "application/xml",
    "enabled": true,
    "headers": {
      "X-Biller-Code": "AGUAS-01"
    },
    "method": "POST",
    "template": "<pagamento><referencia>{{xml .reference}}</referencia><valor>{{cents .total}}</valor><data>{{date \"DD/MM/YYYY HH:mm\" .paid_at}}</data></pagamento>",
    "url": "https://lsp.example/kulpay/pagamentos"
  },
  "product": "FACTURA",
  "report": {
    "auth": "bearer",
    "columns": [
      {
        "field": "paid_at",
        "header": "DATA",
        "width": 10
      },
      {
        "field": "invoice_number",
        "header": "FACTURA",
        "width": 12
      },
      {
        "align": "right",
        "field": "total",
        "header": "VALOR",
        "width": 10
      }
    ],
    "date_format": "DD/MM/YYYY",
    "decimal_separator": ",",
    "enabled": true,
    "file_name": "AGUAS_{date}.dat",
    "format": "txt",
    "header": true,
    "last_day": "2026-10-19",
    "line_ending": "lf",
    "url": "https://lsp.example/kulpay/reconciliacao"
  },
  "updated_at": "2026-10-20T08:00:00Z",
  "version": 3
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "biller": "AGUAS",
  "fields": [
    "event",
    "notification_id",
    "payment_id",
    "request_id",
    "mode",
    "biller",
    "biller_name",
    "product",
    "supplier_product",
    "reference",
    "invoice_number",
    "amount",
    "payer_fee",
    "total",
    "currency",
    "amount_minor",
    "total_minor",
    "paid_at",
    "channel_id",
    "channel_name",
    "funding",
    "partner_reference",
    "supplier_reference",
    "receipt_url"
  ],
  "mode": "test",
  "notification": {
    "auth": "hmac",
    "content_type": "application/xml",
    "enabled": true,
    "headers": {
      "X-Biller-Code": "AGUAS-01"
    },
    "method": "POST",
    "template": "<pagamento><referencia>{{xml .reference}}</referencia><valor>{{cents .total}}</valor><data>{{date \"DD/MM/YYYY HH:mm\" .paid_at}}</data></pagamento>",
    "url": "https://lsp.example/kulpay/pagamentos"
  },
  "product": "FACTURA",
  "report": {
    "auth": "bearer",
    "columns": [
      {
        "field": "paid_at",
        "header": "DATA",
        "width": 10
      },
      {
        "field": "invoice_number",
        "header": "FACTURA",
        "width": 12
      },
      {
        "align": "right",
        "field": "total",
        "header": "VALOR",
        "width": 10
      }
    ],
    "date_format": "DD/MM/YYYY",
    "decimal_separator": ",",
    "enabled": true,
    "file_name": "AGUAS_{date}.dat",
    "format": "txt",
    "header": true,
    "last_day": "2026-10-19",
    "line_ending": "lf",
    "url": "https://lsp.example/kulpay/reconciliacao"
  },
  "updated_at": "2026-10-20T08:00:00Z",
  "version": 3
}

{
  "code": "invalid_request",
  "detail": "notification: the template does not render well-formed XML (use {{xml .field}} for values)",
  "error": {
    "code": "invalid_request",
    "message": "notification: the template does not render well-formed XML (use {{xml .field}} for values)"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "attempts": 1,
      "content_type": "application/xml",
      "created_at": "2026-10-20T08:00:00Z",
      "delivered_at": "2026-10-20T08:00:01Z",
      "duration_ms": 84,
      "id": "3KvxDelivery00000000000001",
      "integration_id": "3KvxIntegration0000000001",
      "kind": "notification",
      "method": "POST",
      "mode": "test",
      "next_attempt_at": "2026-10-20T08:00:00Z",
      "response_code": 200,
      "status": "delivered",
      "subject_id": "3KvxPayment000000000000001",
      "updated_at": "2026-10-20T08:00:01Z",
      "url": "https://lsp.example/kulpay/pagamentos"
    }
  ]
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "body": "<pagamento><referencia>CL-1</referencia><valor>151000</valor><data>19/10/2026 12:00</data></pagamento>",
  "delivery": {
    "attempts": 1,
    "content_type": "application/xml",
    "created_at": "2026-10-20T08:00:00Z",
    "delivered_at": "2026-10-20T08:00:01Z",
    "duration_ms": 84,
    "id": "3KvxDelivery00000000000001",
    "integration_id": "3KvxIntegration0000000001",
    "kind": "notification",
    "method": "POST",
    "mode": "test",
    "next_attempt_at": "2026-10-20T08:00:00Z",
    "response_code": 200,
    "status": "delivered",
    "subject_id": "3KvxPayment000000000000001",
    "updated_at": "2026-10-20T08:00:01Z",
    "url": "https://lsp.example/kulpay/pagamentos"
  }
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "body": "<pagamento>…</pagamento>",
  "delivery": {
    "attempts": 1,
    "content_type": "application/xml",
    "created_at": "2026-10-20T08:00:00Z",
    "delivered_at": "2026-10-20T08:00:01Z",
    "duration_ms": 84,
    "id": "3KvxDelivery00000000000001",
    "integration_id": "3KvxIntegration0000000001",
    "kind": "notification",
    "method": "POST",
    "mode": "test",
    "next_attempt_at": "2026-10-20T08:00:00Z",
    "response_code": 200,
    "status": "delivered",
    "subject_id": "3KvxPayment000000000000001",
    "updated_at": "2026-10-20T08:00:01Z",
    "url": "https://lsp.example/kulpay/pagamentos"
  }
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "body": "<pagamento><referencia>EX-123456</referencia><valor>126000</valor><data>19/10/2026 16:30</data></pagamento>",
  "content_type": "application/xml"
}

{
  "code": "invalid_request",
  "detail": "template: unexpected \"}\" in operand",
  "error": {
    "code": "invalid_request",
    "message": "template: unexpected \"}\" in operand"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "approval": {
    "created_at": "2026-10-10T22:15:00.011523819Z",
    "id": "3KWPlO70sHMc9BFjsbRiot7VUEk",
    "kind": "bill.limits",
    "payload": "{\"reference_daily_count\":3,\"reference_daily_minor\":0,\"channel_daily_minor\":1000000}",
    "prepared_by": "key_accounts",
    "reason": "policy",
    "status": "pending",
    "subject_id": "3KWPlDIPesBSi4VERFPanmdB27f",
    "tenant_id": "platform"
  }
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "active": true,
  "code": "TVBASIC",
  "id": "3KUXY1uKd7kWn4xZoQqDh9FbSl1",
  "name": "Pacote Básico",
  "price_minor": 75000,
  "updated_at": "2026-10-11T09:25:18Z",
  "validity": "30d"
}

{
  "code": "invalid_request",
  "detail": "an offer needs a code (capital letters, digits, _), a name and a positive price_minor",
  "error": {
    "code": "invalid_request",
    "message": "an offer needs a code (capital letters, digits, _), a name and a positive price_minor"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "refreshed": 2
}

{
  "code": "invalid_request",
  "detail": "the edm driver does not list offers",
  "error": {
    "code": "invalid_request",
    "message": "the edm driver does not list offers"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

DATA      FACTURA          VALOR
19/10/2026F-N1           1510,00

{
  "code": "invalid_request",
  "detail": "the day is YYYY-MM-DD",
  "error": {
    "code": "invalid_request",
    "message": "the day is YYYY-MM-DD"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "count": 1,
      "created_at": "2026-10-10T22:14:59.538329669Z",
      "currency": "MZN",
      "fee_minor": 0,
      "gross_minor": 150000,
      "id": "3KWPlF7nZdWEWid2kjF1ZQJ718o",
      "mode": "test",
      "net_minor": 150000,
      "period_from": "2026-10-10T22:14:59.495269929Z",
      "period_to": "2026-10-10T22:14:59.495269929Z",
      "status": "pending"
    }
  ],
  "total": 1
}

{
  "approval": {
    "created_at": "2026-10-10T22:14:57.89256229Z",
    "id": "3KWPkwtupluYYLGAw7At48TbMyG",
    "kind": "bill.biller_status",
    "payload": "{\"status\":\"active\"}",
    "prepared_by": "key_accounts",
    "reason": "contract",
    "status": "pending",
    "subject_id": "3KWPkylzKmRsF6Rq3xef8pjun2x",
    "tenant_id": "platform"
  }
}

{
  "code": "invalid_request",
  "detail": "the biller needs an enabled product with a supply connector before it is activated",
  "error": {
    "code": "invalid_request",
    "message": "the biller needs an enabled product with a supply connector before it is activated"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "approval_id": "3KWPlGFxMcmtqjHW45BKc6Jqgkq",
      "bps": 150,
      "channel_id": "3KWPl9fd5z3WDdnaGzpvnzDkLUW",
      "created_at": "2026-10-10T22:14:59.95764134Z",
      "created_by": "key_accounts",
      "direction": "we_pay",
      "effective_from": "2026-10-10T22:14:59.95764134Z",
      "id": "3KWPlHvsSlANI9980QIV6EKj9y4",
      "status": "active",
      "version": 1
    }
  ],
  "total": 1
}

{
  "approval_id": "3KWPlGFxMcmtqjHW45BKc6Jqgkq",
  "bps": 150,
  "channel_id": "3KWPl9fd5z3WDdnaGzpvnzDkLUW",
  "created_at": "2026-10-10T22:14:59.95764134Z",
  "created_by": "key_accounts",
  "direction": "we_pay",
  "effective_from": "2026-10-10T22:14:59.95764134Z",
  "id": "3KWPlHvsSlANI9980QIV6EKj9y4",
  "status": "pending",
  "version": 1
}

{
  "code": "invalid_request",
  "detail": "direction is we_pay or we_charge",
  "error": {
    "code": "invalid_request",
    "message": "direction is we_pay or we_charge"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "data": [
    {
      "amount_minor": 500000,
      "approval_id": "3KWPlAON5BFKuGPEjNuGpBV06KB",
      "bank_reference": "BCI-1",
      "connector_id": "3KWPkweeFBr3p9OxYa5dTFjzMCF",
      "created_at": "2026-10-10T22:14:58.017507082Z",
      "created_by": "key_accounts",
      "currency": "MZN",
      "id": "3KWPl6P3YYG5B9DI0Klb9fMlSUu",
      "status": "pending"
    }
  ],
  "total": 1
}

{
  "billers": [
    {
      "biller": "EDM",
      "biller_name": "Electricidade de Moçambique",
      "products": [
        "CREDELEC"
      ]
    },
    {
      "biller": "LUZ",
      "biller_name": "Luz do Norte",
      "products": [
        "CONTA"
      ]
    }
  ],
  "reference": "01123456782",
  "rf": false,
  "then": "these billers, in parallel; the deposit resolver if none knows it",
  "too_many": false
}

{
  "code": "invalid_request",
  "detail": "a reference is 3 to 128 characters",
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "data": [
    {
      "approval_id": "3KWPlDhVsFz6D7Nlw0sljeII8l1",
      "bank_reference": "BCI-1",
      "count": 1,
      "created_at": "2026-10-10T22:14:59.538329669Z",
      "currency": "MZN",
      "fee_minor": 0,
      "gross_minor": 150000,
      "id": "3KWPlF7nZdWEWid2kjF1ZQJ718o",
      "mode": "test",
      "net_minor": 150000,
      "paid_at": "2026-10-10T22:14:59.591566406Z",
      "period_from": "2026-10-10T22:14:59.495269929Z",
      "period_to": "2026-10-10T22:14:59.495269929Z",
      "status": "paid"
    }
  ],
  "total": 1
}

{
  "approval": {
    "created_at": "2026-10-10T22:14:59.570339309Z",
    "id": "3KWPlDhVsFz6D7Nlw0sljeII8l1",
    "kind": "bill.remittance_paid",
    "payload": "{\"bank_reference\":\"BCI-1\"}",
    "prepared_by": "key_accounts",
    "reason": "daily",
    "status": "pending",
    "subject_id": "3KWPlF7nZdWEWid2kjF1ZQJ718o",
    "tenant_id": "platform"
  }
}

{
  "code": "invalid_request",
  "detail": "the remittance is already paid",
  "error": {
    "code": "invalid_request",
    "message": "the remittance is already paid"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "data": [
    {
      "config": {
        "float_minor": 5000000
      },
      "created_at": "2026-10-10T22:14:57.717491719Z",
      "driver": "fake",
      "enabled": true,
      "float_at": "2026-10-10T22:14:57.742829025Z",
      "float_currency": "MZN",
      "float_minor": 5000000,
      "health": "healthy",
      "health_at": "2026-10-10T22:14:57.762013874Z",
      "id": "3KWPkweeFBr3p9OxYa5dTFjzMCF",
      "mode": "test",
      "name": "fake-test",
      "updated_at": "2026-10-10T22:14:57.717491719Z"
    }
  ],
  "total": 1
}

{
  "config": {
    "float_minor": 5000000
  },
  "created_at": "2026-10-10T22:14:57.717491719Z",
  "driver": "fake",
  "enabled": true,
  "health": "healthy",
  "id": "3KWPkweeFBr3p9OxYa5dTFjzMCF",
  "mode": "test",
  "name": "fake-test",
  "updated_at": "2026-10-10T22:14:57.717491719Z"
}

{
  "code": "invalid_request",
  "detail": "mode is live or test",
  "error": {
    "code": "invalid_request",
    "message": "mode is live or test"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "config": {
    "float_minor": 5000000
  },
  "created_at": "2026-10-10T22:14:57.717491719Z",
  "driver": "fake",
  "enabled": true,
  "float_at": "2026-10-10T22:14:57.742829025Z",
  "float_currency": "MZN",
  "float_minor": 5000000,
  "health": "healthy",
  "health_at": "2026-10-10T22:14:57.762013874Z",
  "id": "3KWPkweeFBr3p9OxYa5dTFjzMCF",
  "low_float_minor": 100000,
  "mode": "test",
  "name": "fake-test",
  "updated_at": "2026-10-10T22:14:57.992068663Z"
}

{
  "code": "invalid_request",
  "detail": "the fake driver is for test mode only",
  "error": {
    "code": "invalid_request",
    "message": "the fake driver is for test mode only"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "amount_minor": 500000,
  "approval_id": "3KWPlAON5BFKuGPEjNuGpBV06KB",
  "bank_reference": "BCI-1",
  "connector_id": "3KWPkweeFBr3p9OxYa5dTFjzMCF",
  "created_at": "2026-10-10T22:14:58.017507082Z",
  "created_by": "key_accounts",
  "currency": "MZN",
  "id": "3KWPl6P3YYG5B9DI0Klb9fMlSUu",
  "status": "pending"
}

{
  "code": "invalid_request",
  "detail": "a positive amount_minor and the bank_reference of the transfer are required",
  "error": {
    "code": "invalid_request",
    "message": "a positive amount_minor and the bank_reference of the transfer are required"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "config": {
    "float_minor": 5000000
  },
  "created_at": "2026-10-10T22:14:57.717491719Z",
  "driver": "fake",
  "enabled": true,
  "float_at": "2026-10-10T22:14:57.742829025Z",
  "float_currency": "MZN",
  "float_minor": 5000000,
  "health": "healthy",
  "health_at": "2026-10-10T22:14:57.762013874Z",
  "id": "3KWPkweeFBr3p9OxYa5dTFjzMCF",
  "mode": "test",
  "name": "fake-test",
  "updated_at": "2026-10-10T22:14:57.717491719Z"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "breaks": 2,
  "breaks_list": [
    {
      "bill_payment_id": "3KUYJ7FUo4vHy1IKzBbOs5QmDw2",
      "customer_reference": "07012345678",
      "kind": "amount_mismatch",
      "kulpay_amount_minor": 100000,
      "request_id": "3KUYK1GVp7wIz4JLACcPt8RnEx3",
      "supplier_amount_minor": 50000,
      "supplier_reference": "EDM-20261010-558213"
    },
    {
      "bill_payment_id": "3KUYL4HWq1xJA7KMBDdQu2SoFy4",
      "customer_reference": "07019876543",
      "kind": "kulpay_only",
      "kulpay_amount_minor": 25000,
      "request_id": "3KUYM7IXr4yKB1LNCEeRv5TpGz5",
      "supplier_reference": "EDM-20261010-558990"
    }
  ],
  "connector": "edm_live",
  "connector_id": "3KUXT4pDy6eRf8sUhJkYc2AwMg6",
  "created_at": "2026-10-11T06:00:41Z",
  "day": "2026-10-10T00:00:00Z",
  "id": "3KUYI4ETn1uGx7HJyAaNr2PlCv1",
  "kulpay_count": 1288,
  "matched": 1286,
  "source": "file",
  "supplier_count": 1287
}

{
  "code": "invalid_request",
  "detail": "the header needs amount and request_id or supplier_reference",
  "error": {
    "code": "invalid_request",
    "message": "the header needs amount and request_id or supplier_reference"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "description": "Simulated supplier for test mode and the local stack; magic references choose the outcome.",
      "fields": [
        "float_minor",
        "currency"
      ],
      "name": "fake",
      "shapes": [
        "metered_prepaid",
        "account_topup"
      ]
    }
  ]
}

{
  "channel_id": "3KWPl9fd5z3WDdnaGzpvnzDkLUW",
  "commission": "0.00",
  "currency": "MZN",
  "lines": [
    {
      "amount": "1500.00",
      "bill_payment_id": "3KWPlDKa4bRtfAl70HOzBdgc2WY",
      "biller": "AGUAS",
      "commission": "0.00",
      "completed_at": "2026-10-10T22:14:59.495269929Z",
      "product": "FACTURA"
    }
  ],
  "month": "2026-10",
  "sales": 1,
  "volume": "1500.00"
}

{
  "code": "not_found",
  "detail": "no such invoice document",
  "error": {
    "code": "not_found",
    "message": "no such invoice document"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "recorded": false,
  "type": "opened"
}

{
  "recorded": true,
  "type": "pinned"
}

{
  "code": "invalid_request",
  "detail": "the payer is not subscribed to this invoice's account",
  "error": {
    "code": "invalid_request",
    "message": "the payer is not subscribed to this invoice's account"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_closed",
  "detail": "invoice F-Q takes no payments, so it has no QR",
  "error": {
    "code": "invoice_closed",
    "message": "invoice F-Q takes no payments, so it has no QR"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_closed",
  "detail": "invoice F-Q takes no payments, so it has no QR",
  "error": {
    "code": "invoice_closed",
    "message": "invoice F-Q takes no payments, so it has no QR"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "data": [
    {
      "amount": "250.00",
      "artifacts": [
        {
          "type": "receipt",
          "value": "FK2026101045631213"
        },
        {
          "meta": {
            "krn": "1",
            "sgc": "600123",
            "ti": "1"
          },
          "type": "token",
          "unit_type": "kWh",
          "units": "25.00",
          "value": "69556183477675547957"
        }
      ],
      "biller": "EDM",
      "biller_name": "EDM",
      "breakdown": {
        "lines": [
          {
            "amount": "250.00",
            "concept": "Unit charge per kWh",
            "price": "10.00",
            "units": "25.00"
          }
        ],
        "unit_type": "kWh",
        "units": "25.00"
      },
      "completed_at": "2026-10-10T22:14:58.744497415Z",
      "created_at": "2026-10-10T22:14:58.651626029Z",
      "currency": "MZN",
      "customer_name": "C****** T**** 7***",
      "customer_reference": "01234567890",
      "fee_bearer": "payer",
      "funding": "balance",
      "id": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
      "mode": "test",
      "object": "bill_payment",
      "participants": [
        {
          "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
          "name": "Tenant B",
          "role": "initiating_psp"
        },
        {
          "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
          "name": "Tenant B",
          "role": "from_psp",
          "settlement": "prefunded_balance"
        }
      ],
      "partner_reference": "POS-9",
      "payer_fee": "5.00",
      "product": "CREDELEC",
      "product_version": 1,
      "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
      "receipt_url": "/bills/receipt/3KWPl4pk0XxRI4TEVI6avRgrj1y?t=plain%3AYmlsbC1yZWNlaXB0fDNLV1BsNHBrMFh4Ukk0VEVWSTZhdlJncmoxeQ",
      "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
      "shape": "metered_prepaid",
      "status": "succeeded",
      "supplier_reference": "FK2026101045631213",
      "total": "255.00"
    }
  ],
  "total": 1
}

{
  "accepted_at": "2026-10-10T22:14:58.70112Z",
  "amount": "250.00",
  "amount_minor": 25000,
  "artifacts": [
    {
      "type": "receipt",
      "value": "FK2026101045631213"
    },
    {
      "meta": {
        "krn": "1",
        "sgc": "600123",
        "ti": "1"
      },
      "type": "token",
      "unit_type": "kWh",
      "units": "25.00",
      "value": "69556183477675547957"
    }
  ],
  "biller": "EDM",
  "biller_name": "EDM",
  "breakdown": {
    "lines": [
      {
        "amount": "250.00",
        "concept": "Unit charge per kWh",
        "price": "10.00",
        "units": "25.00"
      }
    ],
    "unit_type": "kWh",
    "units": "25.00"
  },
  "completed_at": "2026-10-10T22:14:58.744497415Z",
  "created_at": "2026-10-10T22:14:58.651626029Z",
  "currency": "MZN",
  "customer_name": "C****** T**** 7***",
  "customer_reference": "01234567890",
  "fee_bearer": "payer",
  "fulfilment": {
    "attempts": 1,
    "evidence": {
      "authenticated_by": "connector_session",
      "connector_id": "3KWPl3x9eQf0yX1oVJm2aQ8bLtR",
      "driver": "edm",
      "observed_at": "2026-10-10T22:14:58.744497415Z",
      "outcome": "succeeded",
      "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
      "result_sha256": "5c1f0e6b2d9a4c7e8f3a1b2c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f70",
      "source": "fulfil_response",
      "supplier_reference": "FK2026101045631213"
    },
    "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
    "status": "succeeded",
    "supplier_reference": "FK2026101045631213"
  },
  "funding": "balance",
  "id": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
  "mode": "test",
  "object": "bill_payment",
  "participants": [
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "initiating_psp"
    },
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "from_psp",
      "settlement": "prefunded_balance"
    }
  ],
  "partner_reference": "POS-9",
  "payer_fee": "5.00",
  "payer_fee_minor": 500,
  "payment_status": "captured",
  "product": "CREDELEC",
  "product_version": 1,
  "purchase_mode": "variable_amount",
  "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
  "receipt_url": "/bills/receipt/3KWPl4pk0XxRI4TEVI6avRgrj1y?t=plain%3AYmlsbC1yZWNlaXB0fDNLV1BsNHBrMFh4Ukk0VEVWSTZhdlJncmoxeQ",
  "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
  "shape": "metered_prepaid",
  "status": "succeeded",
  "supplier_connector": "edm-live",
  "supplier_reference": "FK2026101045631213",
  "total": "255.00",
  "total_minor": 25500
}

{
  "amount": "250.00",
  "artifacts": [
    {
      "meta": {
        "key": "1250.00"
      },
      "serial": "string",
      "type": "token",
      "unit_type": "string",
      "units": "string",
      "value": "1250.00"
    }
  ],
  "biller": "EDM",
  "biller_name": "Electricidade de Moçambique",
  "breakdown": {
    "debt": "250.00",
    "lines": [
      {
        "amount": "250.00",
        "concept": "string",
        "price": "string",
        "units": "string"
      }
    ],
    "unit_type": "kWh",
    "units": "25.00"
  },
  "completed_at": "2026-10-10T09:30:00Z",
  "created_at": "2026-10-10T09:30:00Z",
  "currency": "MZN",
  "customer_name": "Electricidade de Moçambique",
  "customer_reference": "2003014567",
  "failure_code": "EDM",
  "failure_message": "Pagamento de energia, outubro",
  "fee_bearer": "payer",
  "funding": "balance",
  "id": "3KUXQ43bztiuf9tCMNgbcrYvne3",
  "mode": "test",
  "object": "bill_payment",
  "offer": "string",
  "partner_reference": "2003014567",
  "payer_fee": "250.00",
  "product": "CREDELEC",
  "product_version": 1,
  "quote_expires_at": "2026-10-10T09:30:00Z",
  "request_id": "3KUXQ43bztiuf9tCMNgbcrYvne3",
  "shape": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "status": "quoted",
  "supplier_reference": "2003014567",
  "total": "250.00"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "quote_used",
  "detail": "this quote was already paid (bill payment 3KWPl4pk0XxRI4TEVI6avRgrj1y is succeeded)",
  "error": {
    "code": "quote_used",
    "message": "this quote was already paid (bill payment 3KWPl4pk0XxRI4TEVI6avRgrj1y is succeeded)"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "insufficient_balance",
  "detail": "the balance (10.00 MZN) does not cover 255.00 MZN",
  "error": {
    "code": "insufficient_funds",
    "message": "the balance (10.00 MZN) does not cover 255.00 MZN"
  },
  "legacy_code": "insufficient_funds",
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "code": "biller_unavailable",
  "detail": "the supplier is not answering; try again shortly",
  "error": {
    "code": "biller_unavailable",
    "message": "the supplier is not answering; try again shortly"
  },
  "status": 503,
  "title": "Service Unavailable",
  "type": "about:blank"
}

{
  "account": "AC01234567890",
  "biller": "EDM",
  "cached": false,
  "constraints": {
    "max": "50000.00",
    "min": "10.00"
  },
  "currency": "MZN",
  "customer_name": "C****** T**** 7***",
  "customer_reference": "01234567890",
  "expires_at": "2026-10-10T22:29:58.620381112Z",
  "lookup_id": "3KWPl4LcDleeGYpoU9aYN7alhT5",
  "product": "CREDELEC",
  "status": "found",
  "tariff": "Prepaid Domestic 1PH"
}

{
  "code": "invalid_request",
  "detail": "customer_reference is not a valid contador",
  "error": {
    "code": "invalid_request",
    "message": "customer_reference is not a valid contador"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "reference_rejected",
  "detail": "Contador 100234567 não existe",
  "error": {
    "code": "reference_rejected",
    "message": "Contador 100234567 não existe"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "code": "biller_unavailable",
  "detail": "the supplier is not answering; try again shortly",
  "error": {
    "code": "biller_unavailable",
    "message": "the supplier is not answering; try again shortly"
  },
  "status": 503,
  "title": "Service Unavailable",
  "type": "about:blank"
}

{
  "amount": "250.00",
  "amount_minor": 25000,
  "biller": "EDM",
  "biller_name": "EDM",
  "breakdown": {
    "lines": [
      {
        "amount": "250.00",
        "concept": "Unit charge per kWh",
        "price": "10.00",
        "units": "25.00"
      }
    ],
    "unit_type": "kWh",
    "units": "25.00"
  },
  "created_at": "2026-10-10T22:14:58.651626029Z",
  "currency": "MZN",
  "customer_name": "C****** T**** 7***",
  "customer_reference": "01234567890",
  "fee_bearer": "payer",
  "fulfilment": {
    "attempts": 0,
    "status": "not_started"
  },
  "id": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
  "mode": "test",
  "object": "bill_payment",
  "participants": [
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "initiating_psp"
    },
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "from_psp",
      "settlement": "prefunded_balance"
    }
  ],
  "payer_fee": "5.00",
  "payer_fee_minor": 500,
  "payment_status": "none",
  "product": "CREDELEC",
  "product_version": 1,
  "purchase_mode": "variable_amount",
  "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
  "shape": "metered_prepaid",
  "status": "quoted",
  "supplier_connector": "edm-live",
  "total": "255.00",
  "total_minor": 25500
}

{
  "code": "invalid_request",
  "detail": "amount must be a positive decimal",
  "error": {
    "code": "invalid_request",
    "message": "amount must be a positive decimal"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "amount_out_of_range",
  "detail": "the amount must be between 20.00 MZN and 50000.00 MZN",
  "error": {
    "code": "amount_out_of_range",
    "message": "the amount must be between 20.00 MZN and 50000.00 MZN"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "code": "biller_unavailable",
  "detail": "the supplier is not answering; try again shortly",
  "error": {
    "code": "biller_unavailable",
    "message": "the supplier is not answering; try again shortly"
  },
  "status": 503,
  "title": "Service Unavailable",
  "type": "about:blank"
}

{
  "amount": "250.00",
  "amount_minor": 25000,
  "biller": "EDM",
  "biller_name": "EDM",
  "breakdown": {
    "lines": [
      {
        "amount": "250.00",
        "concept": "Unit charge per kWh",
        "price": "10.42",
        "units": "24.00"
      }
    ],
    "unit_type": "kWh",
    "units": "24.00"
  },
  "created_at": "2026-10-10T22:14:58.651626029Z",
  "currency": "MZN",
  "customer_name": "C****** T**** 7***",
  "customer_reference": "01234567890",
  "fee_bearer": "payer",
  "fulfilment": {
    "attempts": 0,
    "status": "not_started"
  },
  "id": "3KWPl9Qy0bWm2ZkT4dNfE1sH7aP",
  "mode": "test",
  "object": "bill_payment",
  "participants": [
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "initiating_psp"
    },
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "from_psp",
      "settlement": "prefunded_balance"
    }
  ],
  "payer_fee": "5.00",
  "payer_fee_minor": 500,
  "payment_status": "none",
  "product": "CREDELEC",
  "product_version": 1,
  "purchase_mode": "variable_amount",
  "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
  "refreshed_from": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
  "shape": "metered_prepaid",
  "status": "quoted",
  "supplier_connector": "edm-live",
  "total": "255.00",
  "total_minor": 25500
}

{
  "code": "invalid_request",
  "detail": "an invoice is quoted again with invoice_id",
  "error": {
    "code": "invalid_request",
    "message": "an invoice is quoted again with invoice_id"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "quote_invalidated",
  "detail": "the supplier that issued this quote no longer sells Credelec; request a new quote",
  "error": {
    "code": "quote_invalidated",
    "message": "the supplier that issued this quote no longer sells Credelec; request a new quote"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "amount_out_of_range",
  "detail": "the amount must be between 20.00 MZN and 50000.00 MZN",
  "error": {
    "code": "amount_out_of_range",
    "message": "the amount must be between 20.00 MZN and 50000.00 MZN"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "code": "biller_unavailable",
  "detail": "the supplier is not answering; try again shortly",
  "error": {
    "code": "biller_unavailable",
    "message": "the supplier is not answering; try again shortly"
  },
  "status": 503,
  "title": "Service Unavailable",
  "type": "about:blank"
}

{
  "amount": "250.00",
  "artifacts": [
    {
      "type": "receipt",
      "value": "FK2026101045631213"
    },
    {
      "meta": {
        "krn": "1",
        "sgc": "600123",
        "ti": "1"
      },
      "type": "token",
      "unit_type": "kWh",
      "units": "25.00",
      "value": "69556183477675547957"
    }
  ],
  "biller": "EDM",
  "biller_name": "EDM",
  "breakdown": {
    "lines": [
      {
        "amount": "250.00",
        "concept": "Unit charge per kWh",
        "price": "10.00",
        "units": "25.00"
      }
    ],
    "unit_type": "kWh",
    "units": "25.00"
  },
  "completed_at": "2026-10-10T22:14:58.744497415Z",
  "created_at": "2026-10-10T22:14:58.651626029Z",
  "currency": "MZN",
  "customer_name": "C****** T**** 7***",
  "customer_reference": "01234567890",
  "fee_bearer": "payer",
  "funding": "balance",
  "id": "3KWPl4pk0XxRI4TEVI6avRgrj1y",
  "mode": "test",
  "object": "bill_payment",
  "participants": [
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "initiating_psp"
    },
    {
      "account_id": "3KWPl6gHAomFsLp2Cbl41VxBTab",
      "name": "Tenant B",
      "role": "from_psp",
      "settlement": "prefunded_balance"
    }
  ],
  "partner_reference": "POS-9",
  "payer_fee": "5.00",
  "product": "CREDELEC",
  "product_version": 1,
  "quote_expires_at": "2026-10-10T22:24:58.651608397Z",
  "receipt_url": "/bills/receipt/3KWPl4pk0XxRI4TEVI6avRgrj1y?t=plain%3AYmlsbC1yZWNlaXB0fDNLV1BsNHBrMFh4Ukk0VEVWSTZhdlJncmoxeQ",
  "request_id": "kp-3KWPl4pk0XxRI4TEVI6avRgrj1y-1",
  "shape": "metered_prepaid",
  "status": "succeeded",
  "supplier_reference": "FK2026101045631213",
  "total": "255.00"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "to": "***********.com",
  "via": "email"
}

{
  "code": "invalid_request",
  "detail": "via is sms or email",
  "error": {
    "code": "invalid_request",
    "message": "via is sms or email"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such bill payment or quote",
  "error": {
    "code": "not_found",
    "message": "no such bill payment or quote"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "resend_limit",
  "detail": "the artifacts were already sent again 3 times",
  "error": {
    "code": "resend_limit",
    "message": "the artifacts were already sent again 3 times"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "code": "sms_unavailable",
  "detail": "this gateway has no SMS channel configured; send by email",
  "error": {
    "code": "sms_unavailable",
    "message": "this gateway has no SMS channel configured; send by email"
  },
  "status": 503,
  "title": "Service Unavailable",
  "type": "about:blank"
}

{
  "biller": "AGUAS",
  "mode": "live",
  "png_url": "/v1/biller/accounts/CL-001234/qr.png",
  "reference": "CL-001234",
  "svg_url": "/v1/biller/accounts/CL-001234/qr.svg",
  "url": "https://pay.kulpay.co.mz/pay/account/bB9BR1VBUx8fQ0wtMDA0Mg.3oT2Lw9sQe1Zk7mN"
}

{
  "code": "invalid_request",
  "detail": "no product of AGUAS takes CL-****2 as a reference",
  "error": {
    "code": "invalid_request",
    "message": "no product of AGUAS takes CL-****2 as a reference"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invalid_request",
  "detail": "no product of AGUAS takes CL-****2 as a reference",
  "error": {
    "code": "invalid_request",
    "message": "no product of AGUAS takes CL-****2 as a reference"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invalid_request",
  "detail": "no product of AGUAS takes CL-****2 as a reference",
  "error": {
    "code": "invalid_request",
    "message": "no product of AGUAS takes CL-****2 as a reference"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "created": 1,
  "rejected": 1,
  "results": [
    {
      "invoice_id": "3KWPlG2Ons62fPH0IBShlpPJm9n",
      "number": "G-1",
      "result": "created"
    },
    {
      "error": "amount must be a positive decimal",
      "number": "G-2",
      "result": "rejected"
    }
  ],
  "rows": 2,
  "sha256": "90868a50e8b9c3b766597f54aa00e65c587cda5f7454803e5e8a4fb38d9fad00",
  "updated": 0
}

{
  "code": "invalid_request",
  "detail": "the header must have invoice_number, account_reference, amount, currency, issue_date, due_date, description",
  "error": {
    "code": "invalid_request",
    "message": "the header must have invoice_number, account_reference, amount, currency, issue_date, due_date, description"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "file_too_large",
  "detail": "an invoice file is at most 5 MB",
  "error": {
    "code": "file_too_large",
    "message": "an invoice file is at most 5 MB"
  },
  "status": 413,
  "title": "Content Too Large",
  "type": "about:blank"
}

{
  "data": [
    {
      "account_reference": "CL-1",
      "amount": "1500.00",
      "biller": "AGUAS",
      "biller_name": "Águas",
      "currency": "MZN",
      "due_date": "2026-10-31",
      "expires_at": "2026-11-30T00:00:00Z",
      "id": "3KWPlCZORCtehfKOAIkXyowwAqr",
      "issue_date": "2026-10-10",
      "number": "F-1",
      "open": "0.00",
      "paid": "1500.00",
      "status": "paid"
    }
  ],
  "total": 1
}

{
  "created": 2,
  "rejected": 1,
  "results": [
    {
      "invoice_id": "3KWPlCZORCtehfKOAIkXyowwAqr",
      "number": "F-1",
      "result": "created"
    },
    {
      "invoice_id": "3KWPlGyWnT4jx8g7CGpEoWP0GHe",
      "number": "F-2",
      "result": "created"
    }
  ],
  "updated": 0
}

{
  "code": "invalid_request",
  "detail": "send 1 to 1000 invoices",
  "error": {
    "code": "invalid_request",
    "message": "send 1 to 1000 invoices"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "insufficient_scope",
  "detail": "missing required scope: invoices:write",
  "error": {
    "code": "insufficient_scope",
    "message": "missing required scope: invoices:write",
    "missing_scope": "invoices:write"
  },
  "missing_scope": "invoices:write",
  "status": 403,
  "title": "Forbidden",
  "type": "about:blank"
}

{
  "account_reference": "CL-1",
  "amount": "1500.00",
  "biller": "AGUAS",
  "biller_name": "Águas",
  "currency": "MZN",
  "due_date": "2026-10-31",
  "engagement": {
    "opened": 0,
    "pinned": 0
  },
  "expires_at": "2026-11-30T00:00:00Z",
  "id": "3KWPlCZORCtehfKOAIkXyowwAqr",
  "issue_date": "2026-10-10",
  "number": "F-1",
  "open": "1500.00",
  "paid": "0.00",
  "status": "open"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "account_reference": "CL-2",
  "amount": "900.00",
  "biller": "AGUAS",
  "biller_name": "Águas",
  "currency": "MZN",
  "due_date": "2026-10-31",
  "expires_at": "2026-11-30T00:00:00Z",
  "id": "3KWPlGyWnT4jx8g7CGpEoWP0GHe",
  "issue_date": "2026-10-10",
  "number": "F-2",
  "open": "900.00",
  "paid": "0.00",
  "status": "cancelled"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_locked",
  "detail": "invoice F-1 is paid and cannot be changed",
  "error": {
    "code": "invoice_locked",
    "message": "invoice F-1 is paid and cannot be changed"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "account_reference": "100234567",
  "amount": "1250.00",
  "biller": "AGUA-LIMPA",
  "biller_name": "Água Limpa, Lda",
  "currency": "MZN",
  "description": "Consumo de água, setembro de 2026",
  "document": {
    "content_type": "application/pdf",
    "filename": "FT-2026-00123.pdf",
    "size": 84213,
    "url": "/v1/biller/invoices/FT-2026-00123/document"
  },
  "due_date": "2026-10-31",
  "expires_at": "2026-11-30T00:00:00Z",
  "id": "3KnE2odsld9qpNsTIAS3N9RyYRi",
  "issue_date": "2026-10-01",
  "number": "FT-2026-00123",
  "open": "1250.00",
  "paid": "0.00",
  "status": "open"
}

{
  "code": "invalid_request",
  "detail": "the document must be a PDF",
  "error": {
    "code": "invalid_request",
    "message": "the document must be a PDF"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_closed",
  "detail": "invoice FT-2026-00123 is paid: it takes no document",
  "error": {
    "code": "invoice_closed",
    "message": "invoice FT-2026-00123 is paid: it takes no document"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "file_too_large",
  "detail": "an invoice document is at most 5 MB",
  "error": {
    "code": "file_too_large",
    "message": "an invoice document is at most 5 MB"
  },
  "status": 413,
  "title": "Content Too Large",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "created_at": "2026-10-01T06:00:12Z",
      "data": {
        "details": {
          "has_document": false,
          "lines_count": 0,
          "source": "push"
        },
        "invoice": {
          "account_reference": "100234567",
          "amount": "1250.00",
          "biller": "AGUA-LIMPA",
          "currency": "MZN",
          "due_date": "2026-10-31",
          "id": "3KnE2odsld9qpNsTIAS3N9RyYRi",
          "issue_date": "2026-10-01",
          "number": "FT-2026-00123",
          "open": "1250.00",
          "paid": "0.00",
          "status": "open"
        }
      },
      "id": "3KM4b0MSzyoNnAgn5pbS9xwrBQo",
      "sequence": 1,
      "type": "bill_invoice.presented"
    },
    {
      "created_at": "2026-10-01T06:02:40Z",
      "data": {
        "details": {
          "file_id": "3KRlP4WSt8uUE2E2OYdHrWSK4QF",
          "filename": "FT-2026-00123.pdf",
          "size": 84213
        },
        "invoice": {
          "account_reference": "100234567",
          "amount": "1250.00",
          "biller": "AGUA-LIMPA",
          "currency": "MZN",
          "due_date": "2026-10-31",
          "id": "3KnE2odsld9qpNsTIAS3N9RyYRi",
          "issue_date": "2026-10-01",
          "number": "FT-2026-00123",
          "open": "1250.00",
          "paid": "0.00",
          "status": "open"
        }
      },
      "id": "3KjRgUjLWIWhBmLa6Z9fWbpx2xe",
      "sequence": 2,
      "type": "bill_invoice.document_attached"
    }
  ],
  "total": 2
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "number": "FT-2026-0412",
  "pay_url": "https://pay.kulpay.co.mz/pay/invoice/vY1q8m2Kp9sXc3RtLwB7nZ4hJ6fD0aE5gU8iO2yT1kM",
  "payment_reference": "RF47 1234 5678 9012",
  "status": "open"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_closed",
  "detail": "invoice FT-2026-0412 is paid",
  "error": {
    "code": "invoice_closed",
    "message": "invoice FT-2026-0412 is paid"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_closed",
  "detail": "invoice F-Q takes no payments, so it has no QR",
  "error": {
    "code": "invoice_closed",
    "message": "invoice F-Q takes no payments, so it has no QR"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "invoice_closed",
  "detail": "invoice F-Q takes no payments, so it has no QR",
  "error": {
    "code": "invoice_closed",
    "message": "invoice F-Q takes no payments, so it has no QR"
  },
  "status": 409,
  "title": "Conflict",
  "type": "about:blank"
}

{
  "data": [
    {
      "account_reference": "CL-10",
      "created_at": "2026-10-10T22:14:59.775211958Z",
      "lawful_basis": "contract",
      "phone_masked": "*****4567"
    },
    {
      "account_reference": "CL-9",
      "created_at": "2026-10-10T22:14:59.755120163Z",
      "lawful_basis": "contract",
      "phone_masked": "*****4567"
    }
  ],
  "total": 2
}

{
  "results": [
    {
      "account_reference": "CL-9",
      "payers_subscribed": 0,
      "result": "enrolled"
    },
    {
      "account_reference": "CL-10",
      "payers_subscribed": 1,
      "result": "enrolled"
    }
  ]
}

{
  "code": "not_a_biller",
  "detail": "this key's organisation is not a biller on KulPay",
  "error": {
    "code": "not_a_biller",
    "message": "this key's organisation is not a biller on KulPay"
  },
  "status": 403,
  "title": "Forbidden",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "amount_rule": "range",
      "biller_fee": {
        "bearer": "biller",
        "currency": "MZN",
        "fixed": "5.00"
      },
      "code": "CONTA",
      "connectors": [
        {
          "driver": "biller_rest",
          "health": "healthy",
          "mode": "live",
          "name": "aguas-live"
        }
      ],
      "currency": "MZN",
      "customer_reference": {
        "example": "EX-123456",
        "label": "Contrato",
        "pattern": "^EX-\\d{6}$"
      },
      "enabled": true,
      "fee": {
        "bearer": "biller",
        "currency": "MZN"
      },
      "lookup_required": true,
      "max": "50000.00",
      "min": "1.00",
      "model": "agent",
      "name": "Conta de água",
      "purchase_modes": [
        "variable_amount"
      ],
      "routable": true,
      "shape": "postpaid",
      "supplier_product": "AGUA_DOM",
      "version": 2
    }
  ]
}

{
  "code": "not_a_biller",
  "detail": "this key is not a biller's",
  "error": {
    "code": "not_a_biller",
    "message": "this key is not a biller's"
  },
  "status": 403,
  "title": "Forbidden",
  "type": "about:blank"
}

{
  "biller": "AGUAS",
  "fields": [
    "event",
    "notification_id",
    "payment_id",
    "request_id",
    "mode",
    "biller",
    "biller_name",
    "product",
    "supplier_product",
    "reference",
    "invoice_number",
    "amount",
    "payer_fee",
    "total",
    "currency",
    "amount_minor",
    "total_minor",
    "paid_at",
    "channel_id",
    "channel_name",
    "funding",
    "partner_reference",
    "supplier_reference",
    "receipt_url"
  ],
  "mode": "test",
  "notification": {
    "auth": "hmac",
    "content_type": "application/xml",
    "enabled": true,
    "headers": {
      "X-Biller-Code": "AGUAS-01"
    },
    "method": "POST",
    "template": "<pagamento><referencia>{{xml .reference}}</referencia><valor>{{cents .total}}</valor><data>{{date \"DD/MM/YYYY HH:mm\" .paid_at}}</data></pagamento>",
    "url": "https://lsp.example/kulpay/pagamentos"
  },
  "product": "FACTURA",
  "report": {
    "auth": "bearer",
    "columns": [
      {
        "field": "paid_at",
        "header": "DATA",
        "width": 10
      },
      {
        "field": "invoice_number",
        "header": "FACTURA",
        "width": 12
      },
      {
        "align": "right",
        "field": "total",
        "header": "VALOR",
        "width": 10
      }
    ],
    "date_format": "DD/MM/YYYY",
    "decimal_separator": ",",
    "enabled": true,
    "file_name": "AGUAS_{date}.dat",
    "format": "txt",
    "header": true,
    "last_day": "2026-10-19",
    "line_ending": "lf",
    "url": "https://lsp.example/kulpay/reconciliacao"
  },
  "updated_at": "2026-10-20T08:00:00Z",
  "version": 3
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "biller": "AGUAS",
  "fields": [
    "event",
    "notification_id",
    "payment_id",
    "request_id",
    "mode",
    "biller",
    "biller_name",
    "product",
    "supplier_product",
    "reference",
    "invoice_number",
    "amount",
    "payer_fee",
    "total",
    "currency",
    "amount_minor",
    "total_minor",
    "paid_at",
    "channel_id",
    "channel_name",
    "funding",
    "partner_reference",
    "supplier_reference",
    "receipt_url"
  ],
  "mode": "test",
  "notification": {
    "auth": "hmac",
    "content_type": "application/xml",
    "enabled": true,
    "headers": {
      "X-Biller-Code": "AGUAS-01"
    },
    "method": "POST",
    "template": "<pagamento><referencia>{{xml .reference}}</referencia><valor>{{cents .total}}</valor><data>{{date \"DD/MM/YYYY HH:mm\" .paid_at}}</data></pagamento>",
    "url": "https://lsp.example/kulpay/pagamentos"
  },
  "product": "FACTURA",
  "report": {
    "auth": "bearer",
    "columns": [
      {
        "field": "paid_at",
        "header": "DATA",
        "width": 10
      },
      {
        "field": "invoice_number",
        "header": "FACTURA",
        "width": 12
      },
      {
        "align": "right",
        "field": "total",
        "header": "VALOR",
        "width": 10
      }
    ],
    "date_format": "DD/MM/YYYY",
    "decimal_separator": ",",
    "enabled": true,
    "file_name": "AGUAS_{date}.dat",
    "format": "txt",
    "header": true,
    "last_day": "2026-10-19",
    "line_ending": "lf",
    "url": "https://lsp.example/kulpay/reconciliacao"
  },
  "updated_at": "2026-10-20T08:00:00Z",
  "version": 3
}

{
  "code": "invalid_request",
  "detail": "notification: the template does not render well-formed XML (use {{xml .field}} for values)",
  "error": {
    "code": "invalid_request",
    "message": "notification: the template does not render well-formed XML (use {{xml .field}} for values)"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "attempts": 1,
      "content_type": "application/xml",
      "created_at": "2026-10-20T08:00:00Z",
      "delivered_at": "2026-10-20T08:00:01Z",
      "duration_ms": 84,
      "id": "3KvxDelivery00000000000001",
      "integration_id": "3KvxIntegration0000000001",
      "kind": "notification",
      "method": "POST",
      "mode": "test",
      "next_attempt_at": "2026-10-20T08:00:00Z",
      "response_code": 200,
      "status": "delivered",
      "subject_id": "3KvxPayment000000000000001",
      "updated_at": "2026-10-20T08:00:01Z",
      "url": "https://lsp.example/kulpay/pagamentos"
    }
  ]
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "body": "<pagamento><referencia>CL-1</referencia><valor>151000</valor><data>19/10/2026 12:00</data></pagamento>",
  "delivery": {
    "attempts": 1,
    "content_type": "application/xml",
    "created_at": "2026-10-20T08:00:00Z",
    "delivered_at": "2026-10-20T08:00:01Z",
    "duration_ms": 84,
    "id": "3KvxDelivery00000000000001",
    "integration_id": "3KvxIntegration0000000001",
    "kind": "notification",
    "method": "POST",
    "mode": "test",
    "next_attempt_at": "2026-10-20T08:00:00Z",
    "response_code": 200,
    "status": "delivered",
    "subject_id": "3KvxPayment000000000000001",
    "updated_at": "2026-10-20T08:00:01Z",
    "url": "https://lsp.example/kulpay/pagamentos"
  }
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "body": "<pagamento>…</pagamento>",
  "delivery": {
    "attempts": 1,
    "content_type": "application/xml",
    "created_at": "2026-10-20T08:00:00Z",
    "delivered_at": "2026-10-20T08:00:01Z",
    "duration_ms": 84,
    "id": "3KvxDelivery00000000000001",
    "integration_id": "3KvxIntegration0000000001",
    "kind": "notification",
    "method": "POST",
    "mode": "test",
    "next_attempt_at": "2026-10-20T08:00:00Z",
    "response_code": 200,
    "status": "delivered",
    "subject_id": "3KvxPayment000000000000001",
    "updated_at": "2026-10-20T08:00:01Z",
    "url": "https://lsp.example/kulpay/pagamentos"
  }
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "body": "<pagamento><referencia>EX-123456</referencia><valor>126000</valor><data>19/10/2026 16:30</data></pagamento>",
  "content_type": "application/xml"
}

{
  "code": "invalid_request",
  "detail": "template: unexpected \"}\" in operand",
  "error": {
    "code": "invalid_request",
    "message": "template: unexpected \"}\" in operand"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

DATA      FACTURA          VALOR
19/10/2026F-N1           1510,00

{
  "code": "invalid_request",
  "detail": "the day is YYYY-MM-DD",
  "error": {
    "code": "invalid_request",
    "message": "the day is YYYY-MM-DD"
  },
  "status": 400,
  "title": "Invalid request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "count": 1,
      "created_at": "2026-10-10T22:14:59.538329669Z",
      "currency": "MZN",
      "fee_minor": 0,
      "gross_minor": 150000,
      "id": "3KWPlF7nZdWEWid2kjF1ZQJ718o",
      "mode": "test",
      "net_minor": 150000,
      "period_from": "2026-10-10T22:14:59.495269929Z",
      "period_to": "2026-10-10T22:14:59.495269929Z",
      "status": "pending"
    }
  ],
  "total": 1
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "category": "tv",
      "code": "TVCABO",
      "country": "MZ",
      "name": "TV Cabo",
      "products": [
        {
          "amount_rule": "fixed",
          "code": "PACOTE",
          "currency": "MZN",
          "customer_reference": {
            "label": "Smartcard",
            "pattern": "^\\d{10}$"
          },
          "fee": {
            "bearer": "payer",
            "currency": "MZN",
            "fixed": "5.00"
          },
          "fixed": "750.00",
          "lookup_required": false,
          "name": "Pacote",
          "offers": [
            {
              "code": "TVBASIC",
              "currency": "MZN",
              "name": "Pacote Básico",
              "price": "750.00",
              "price_minor": 75000,
              "validity": "30d"
            },
            {
              "code": "TVPREMIUM",
              "currency": "MZN",
              "name": "Pacote Premium",
              "price": "2500.00",
              "price_minor": 250000,
              "validity": "30d"
            }
          ],
          "shape": "account_topup"
        }
      ],
      "support_phone": "+258 21 480 500"
    }
  ],
  "total": 1
}

{
  "category": "tv",
  "code": "TVCABO",
  "country": "MZ",
  "name": "TV Cabo",
  "products": [
    {
      "amount_rule": "fixed",
      "code": "PACOTE",
      "currency": "MZN",
      "customer_reference": {
        "label": "Smartcard",
        "pattern": "^\\d{10}$"
      },
      "fee": {
        "bearer": "payer",
        "currency": "MZN",
        "fixed": "5.00"
      },
      "fixed": "750.00",
      "lookup_required": false,
      "name": "Pacote",
      "offers": [
        {
          "code": "TVBASIC",
          "currency": "MZN",
          "name": "Pacote Básico",
          "price": "750.00",
          "price_minor": 75000,
          "validity": "30d"
        },
        {
          "code": "TVPREMIUM",
          "currency": "MZN",
          "name": "Pacote Premium",
          "price": "2500.00",
          "price_minor": 250000,
          "validity": "30d"
        }
      ],
      "shape": "account_topup"
    }
  ],
  "support_phone": "+258 21 480 500"
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "code": "TVBASIC",
      "currency": "MZN",
      "name": "Pacote Básico",
      "price": "750.00",
      "price_minor": 75000,
      "validity": "30d"
    },
    {
      "code": "TVPREMIUM",
      "currency": "MZN",
      "name": "Pacote Premium",
      "price": "2500.00",
      "price_minor": 250000,
      "validity": "30d"
    }
  ],
  "purchase_modes": [
    "fixed_catalog",
    "variable_amount"
  ]
}

{
  "code": "not_found",
  "detail": "no such biller, product or supply connector",
  "error": {
    "code": "not_found",
    "message": "no such biller, product or supply connector"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "created_at": "2026-06-14T08:30:00Z",
  "email": "ana.macuacuaexample.co.mz",
  "external_id": "CLI-000482",
  "id": "3K4mvOpRKqOU8KwHnmvdbsC0spb",
  "name": "Ana Macuácua",
  "phone": "258841234567"
}

{
  "created_at": "2026-10-10T22:14:59.658576008Z",
  "external_id": "u-1",
  "id": "3KWPlDfQKeSRExAGpYcLFhGY2jR",
  "name": "Ana",
  "phone": "258841234567"
}

{
  "code": "invalid_request",
  "detail": "email is not an email address",
  "error": {
    "code": "invalid_request",
    "message": "email is not an email address"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "created_at": "2026-08-14T12:03:55Z",
  "email": "joana.cossaexample.co.mz",
  "external_id": "cust-000184",
  "id": "3Kpx6EPL2FOQLXxXg0PeZMIUgIx",
  "name": "Joana Cossa",
  "phone": "+258841234567"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "account_reference": "CL-9",
      "alias": "Casa",
      "biller": "AGUAS",
      "biller_name": "Águas",
      "invoice": {
        "account_reference": "CL-9",
        "amount": "300.00",
        "biller": "AGUAS",
        "biller_name": "Águas",
        "currency": "MZN",
        "due_date": "2026-12-31",
        "expires_at": "2027-01-30T00:00:00Z",
        "id": "3KWPlFgLlzNeKjlNMg1Xp9qGbkU",
        "issue_date": "2026-10-10",
        "number": "F-9",
        "open": "300.00",
        "paid": "0.00",
        "status": "open"
      },
      "source": "presented"
    }
  ],
  "total": 1
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "data": [
    {
      "account_reference": "CL-9",
      "alias": "Casa",
      "biller": "AGUAS",
      "biller_name": "Águas",
      "consent_at": "2026-10-10T22:14:59.682786547Z",
      "consent_version": "2026-10",
      "id": "3KWPlDuqLcP8vv2BFC9FcZqeDgd",
      "opted_out_at": "2026-10-10T22:14:59.73153362Z",
      "origin": "payer",
      "status": "opted_out"
    }
  ],
  "total": 1
}

{
  "account_reference": "CL-9",
  "alias": "Casa",
  "biller": "AGUAS",
  "biller_name": "Águas",
  "consent_at": "2026-10-10T22:14:59.682786547Z",
  "consent_version": "2026-10",
  "id": "3KWPlDuqLcP8vv2BFC9FcZqeDgd",
  "origin": "payer",
  "status": "active"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "consent_required",
  "detail": "the payer's consent is required: consent.accepted and the version of the terms they accepted",
  "error": {
    "code": "consent_required",
    "message": "the payer's consent is required: consent.accepted and the version of the terms they accepted"
  },
  "status": 422,
  "title": "Unprocessable Content",
  "type": "about:blank"
}

{
  "account_reference": "CL-9",
  "alias": "Casa",
  "biller": "AGUAS",
  "biller_name": "Águas",
  "consent_at": "2026-10-10T22:14:59.682786547Z",
  "consent_version": "2026-10",
  "id": "3KWPlDuqLcP8vv2BFC9FcZqeDgd",
  "opted_out_at": "2026-10-10T22:14:59.73153362Z",
  "origin": "payer",
  "status": "opted_out"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "consent_at": "2026-10-19T09:30:00Z",
  "consent_version": "autopay-terms-v1",
  "currency": "MZN",
  "days_before_due": 3,
  "funding": "collect",
  "id": "3KtqA2xYz9wV8uT7sR6qP5oN4mL",
  "max_amount": "2000.00",
  "method": "mpesa",
  "mode": "live",
  "phone_masked": "25884****000",
  "runs": [
    {
      "amount": "1500.00",
      "attempts": 0,
      "currency": "MZN",
      "id": "3KtqA1vRk0hS2bWfZ8yYc4mNpQe",
      "invoice_id": "3KtqA0aB2cD3eF4gH5iJ6kL7mN8",
      "invoice_number": "FT-2026-0412",
      "next_attempt_at": "2026-11-07T00:00:00Z",
      "scheduled_for": "2026-11-07T00:00:00Z",
      "status": "scheduled"
    }
  ],
  "status": "active",
  "subscription_id": "3Kt7ugR1VHfcfHLgVg7vXkohaqR"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "consent_at": "2026-10-19T09:30:00Z",
  "consent_version": "autopay-terms-v1",
  "currency": "MZN",
  "days_before_due": 3,
  "funding": "collect",
  "id": "3KtqA2xYz9wV8uT7sR6qP5oN4mL",
  "max_amount": "2000.00",
  "method": "mpesa",
  "mode": "live",
  "phone_masked": "25884****000",
  "runs": [
    {
      "amount": "1500.00",
      "attempts": 0,
      "currency": "MZN",
      "id": "3KtqA1vRk0hS2bWfZ8yYc4mNpQe",
      "invoice_id": "3KtqA0aB2cD3eF4gH5iJ6kL7mN8",
      "invoice_number": "FT-2026-0412",
      "next_attempt_at": "2026-11-07T00:00:00Z",
      "scheduled_for": "2026-11-07T00:00:00Z",
      "status": "scheduled"
    }
  ],
  "status": "active",
  "subscription_id": "3Kt7ugR1VHfcfHLgVg7vXkohaqR"
}

{
  "code": "invalid_request",
  "detail": "max_amount, the most one invoice may be debited for, is a positive decimal",
  "error": {
    "code": "invalid_request",
    "message": "max_amount, the most one invoice may be debited for, is a positive decimal"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "code": "consent_required",
  "detail": "the payer's consent to autopay is required: consent.accepted and the version of the terms they accepted",
  "error": {
    "code": "consent_required",
    "message": "the payer's consent to autopay is required: consent.accepted and the version of the terms they accepted"
  },
  "status": 422,
  "title": "Unprocessable Entity",
  "type": "about:blank"
}

{
  "cancel_reason": "payer asked",
  "cancelled_at": "2026-10-20T08:00:00Z",
  "consent_at": "2026-10-19T09:30:00Z",
  "consent_version": "autopay-terms-v1",
  "currency": "MZN",
  "days_before_due": 3,
  "funding": "collect",
  "id": "3KtqA2xYz9wV8uT7sR6qP5oN4mL",
  "max_amount": "2000.00",
  "method": "mpesa",
  "mode": "live",
  "phone_masked": "25884****000",
  "runs": [
    {
      "amount": "1500.00",
      "attempts": 0,
      "currency": "MZN",
      "id": "3KtqA1vRk0hS2bWfZ8yYc4mNpQe",
      "invoice_id": "3KtqA0aB2cD3eF4gH5iJ6kL7mN8",
      "invoice_number": "FT-2026-0412",
      "reason": "mandate_cancelled",
      "scheduled_for": "2026-11-07T00:00:00Z",
      "status": "skipped"
    }
  ],
  "status": "cancelled",
  "subscription_id": "3Kt7ugR1VHfcfHLgVg7vXkohaqR"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

{
  "consent_at": "2026-10-19T09:30:00Z",
  "consent_version": "autopay-terms-v1",
  "currency": "MZN",
  "days_before_due": 3,
  "funding": "collect",
  "id": "3KtqA2xYz9wV8uT7sR6qP5oN4mL",
  "max_amount": "2000.00",
  "method": "mpesa",
  "mode": "live",
  "phone_masked": "25884****000",
  "runs": [
    {
      "amount": "1500.00",
      "attempts": 0,
      "currency": "MZN",
      "id": "3KtqA1vRk0hS2bWfZ8yYc4mNpQe",
      "invoice_id": "3KtqA0aB2cD3eF4gH5iJ6kL7mN8",
      "invoice_number": "FT-2026-0412",
      "reason": "payer_skipped",
      "scheduled_for": "2026-11-07T00:00:00Z",
      "status": "skipped"
    }
  ],
  "status": "active",
  "subscription_id": "3Kt7ugR1VHfcfHLgVg7vXkohaqR"
}

{
  "code": "invalid_request",
  "detail": "the invoice's autopay is paid and can no longer be skipped",
  "error": {
    "code": "invalid_request",
    "message": "the invoice's autopay is paid and can no longer be skipped"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

{
  "code": "not_found",
  "detail": "no such payer, subscription or enrolment",
  "error": {
    "code": "not_found",
    "message": "no such payer, subscription or enrolment"
  },
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}