> For the complete documentation index, see [llms.txt](https://payments.govstack.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://payments.govstack.global/development-3/8-service-apis/8.3-person-to-government-apis-p2g-bill-payments.md).

# 8.3 Person-to-Government APIs (P2G) Bill Payments

The Bill Payments APIs allow government entities to accept bill payments from persons on digital platforms like mobile money and vouchers.

#### **8.3.1 billInquiryBiller**

This API is called to inquire about bill details from a Bill Aggregator or Govt Entity.

{% openapi src="/files/PansJNWk0m2kneSdMloT" path="/bills/{billId}" method="get" %}
[billInquiryRequest.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2FHThmGT4XMNYj7MN6Cv53%2FbillInquiryRequest.yml?alt=media\&token=eac85daa-8867-4a0e-95c3-1526a53f6de3)
{% endopenapi %}

#### **8.3.2 billrInquiryResponse**

The Payment BB updates the Bill Aggregator or government entity on the status of the Request to Pay.

{% openapi src="/files/wggw2fLjtpKLIbbjdKgw" path="/bills/{billId}" method="post" %}
[v1\_0\_1\_billInquiryResponse.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2FJJi09TflhpW1872JUud5%2Fv1_0_1_billInquiryResponse.yml?alt=media\&token=6d910561-2505-4cee-8fb3-0eec0ab1d476)
{% endopenapi %}

#### **8.3.3 markBillPayment**

This API marks a bill as paid.

{% openapi src="/files/d9p4i8OugFALHuGESq2t" path="/billTransferRequests" method="post" %}
[markBillPpaymentRequest.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2F8JjtkUNHqWKLo590jO88%2FmarkBillPpaymentRequest.yml?alt=media\&token=c39f731e-8c0b-4523-8671-144096a86326)
{% endopenapi %}

#### **8.3.4 billerRtpReq**

The Bill Aggregator or Govt Entity initiates a “Request to Pay” (RTP) through this API.

{% openapi src="/files/i2cjhDNnY6iHRVGsHAVW" path="/billTransferRequests" method="post" %}
[markBillPpaymentResponse.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2FAul5dY3h24hmfFZpjMi4%2FmarkBillPpaymentResponse.yml?alt=media\&token=db54ebcb-a9ba-443e-a883-789cc4e8e79f)
{% endopenapi %}

#### **8.3.5 billerRtpReq**

{% openapi src="/files/Ijrsl5MigugoM6A2XV4N" path="/rtpUpdate" method="post" %}
[billerRtpResponse.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2FvaT1sPyqcOvRWDD8Rg99%2FbillerRtpResponse.yml?alt=media\&token=855348ef-bff6-4653-9fbc-32672e5afee4)
{% endopenapi %}

#### **8.3.6 rtpStatusUpdate**

This API allows the Biller or Aggregator to inquire about the status of its RTP.

{% openapi src="/files/P4TVnG2YVqyBlcRwRqtW" path="/transferRequests/{transferRequestId}" method="get" %}
[rtpStatusUpdateRequest.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2FYWLiiGKDTAnkp300T42D%2FrtpStatusUpdateRequest.yml?alt=media\&token=3d10cc1b-6c6c-4df3-afae-762b2c49909c)
{% endopenapi %}

#### **8.3.7 rtpStatusUpdateResponse**

This API allows the Biller or Aggregator to receive the status of its RTP.

{% openapi src="/files/8vhgVuPX4Gnr4jkD75Dm" path="/transferRequests/{transferRequestId}" method="post" %}
[rtpStatusUpdateResponse.yml](https://1216505995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fewl3vYAk59R7g4crEkvq%2Fuploads%2Fr0FMAQBixWGdgBd0eWW1%2FrtpStatusUpdateResponse.yml?alt=media\&token=b30b22a8-4df1-4c3b-902e-2e5b114116ba)
{% endopenapi %}