---
title: "Bill Payments"
url: "https://oapi-poc.hdbank.work/apis/bill-payments/versions/35217c7f-e421-4a21-bfb3-d1e2b7380f27"
---

# Bill Payments

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Bill Payments","version":"1.7","description":"Thanh toán hóa đơn điện, nước, viễn thông, thẻ tín dụng và khoản vay.\n\nAPI mẫu của cổng thử nghiệm, dữ liệu 100% giả lập. Đơn vị: HDBank (HDBank · Thanh toán). Nhóm: Thanh toán. Trạng thái: GA. Xác thực dự kiến: OAuth 2.0; trên sandbox dùng khóa API."},"servers":[{"url":"https://apis-dev.hdbank.work","description":"Sandbox (dữ liệu giả lập)"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"apikey","description":"Khóa API sandbox cấp khi tạo ứng dụng trên cổng"}},"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}}},"Record":{"type":"object","properties":{"id":{"type":"string"},"api":{"type":"string"},"version":{"type":"string"},"status":{"type":"string"},"note":{"type":"string"}}}}},"paths":{"/bill-payments/v1/records":{"get":{"operationId":"list_bill_payments","summary":"Danh sách bản ghi mẫu","parameters":[{"name":"X-Correlation-ID","in":"header","schema":{"type":"string","format":"uuid"},"description":"Tự sinh nếu thiếu"},{"name":"X-Mock-Scenario","in":"header","schema":{"type":"string","enum":["400","403","409","429","503"]},"description":"Chỉ sandbox: ép mã lỗi để thử"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"sample-001","api":"bill-payments","version":"v1","status":"SAMPLE","note":"Du lieu mau gia lap"}],"total":1}}}},"400":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/bill-payments/v1/records/{id}":{"get":{"operationId":"get_bill_payments","summary":"Chi tiết một bản ghi mẫu","parameters":[{"name":"X-Correlation-ID","in":"header","schema":{"type":"string","format":"uuid"},"description":"Tự sinh nếu thiếu"},{"name":"X-Mock-Scenario","in":"header","schema":{"type":"string","enum":["400","403","409","429","503"]},"description":"Chỉ sandbox: ép mã lỗi để thử"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"sample-001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Record"},"example":{"id":"sample-001","api":"bill-payments","version":"v1","status":"SAMPLE","note":"Du lieu mau gia lap"}}}},"404":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}}}
```