{
  "openapi": "3.1.0",
  "info": {
    "title": "SIC source-derived integration subset",
    "version": "1.7.260928-documentary",
    "description": "Documentary subset, not an approved production contract. All examples are synthetic and not runnable against a live service. No deployment server configured. See x-source and x-issues. Additional source operations remain in the catalog; this subset does not claim complete API coverage. Field coverage and source conditional-presence notes must be read together; no production response branches are inferred."
  },
  "servers": [],
  "paths": {
    "/v2/credentials/authorize": {
      "post": {
        "operationId": "sicAuthorize",
        "tags": [
          "SIC"
        ],
        "summary": "Authorize document digests",
        "x-summary-vi": "Cấp quyền cho digest",
        "description": "Authorize document digests. Documentary extraction; not a validated production contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.260928",
          "physicalPages": [
            30,
            31
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-issues": [
          "SIC-02",
          "SIC-07"
        ],
        "x-next-vi": "Lưu token; mở giao diện cấp quyền được xác nhận, sau đó gọi authorizeCheck.",
        "x-next-en": "Persist the token, use the confirmed authorization view, then call authorizeCheck.",
        "responses": {
          "202": {
            "description": "Accepted for authorization; not a completed signature.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "x-description-vi": "",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "Token returned by the preceding step; do not publish it.",
                      "x-description-vi": "Token của bước trước; không ghi vào log công khai."
                    }
                  },
                  "required": [
                    "token"
                  ]
                },
                "example": {
                  "token": "DEMO_AUTHORIZATION_TOKEN"
                }
              }
            },
            "headers": {
              "x-billcode-id": {
                "description": "Service-generated tracking reference; persist with the local request.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "Service error fields. Exact status/code mapping requires the operation-specific deployment contract.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Error fields are conditional on the operation.",
                  "x-description-vi": "Đối tượng lỗi; trường xuất hiện theo operation.",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Service error code, distinct from HTTP status.",
                      "x-description-vi": "Mã lỗi theo dịch vụ; không phải HTTP status."
                    },
                    "message": {
                      "type": "string",
                      "description": "Short error message.",
                      "x-description-vi": "Thông báo lỗi ngắn."
                    },
                    "description": {
                      "type": "string",
                      "description": "Detailed explanation when present.",
                      "x-description-vi": "Mô tả chi tiết nếu có."
                    }
                  },
                  "required": []
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request fields transcribed from source tables.",
                "x-description-vi": "Cấu trúc request được biên tập từ bảng nguồn.",
                "properties": {
                  "credentialID": {
                    "type": "string",
                    "description": "Credential identifier for the operation.",
                    "x-description-vi": "Identifier credential dùng cho operation."
                  },
                  "numSignatures": {
                    "type": "integer",
                    "description": "Number of signatures to authorize.",
                    "x-description-vi": "Số chữ ký yêu cầu cấp quyền."
                  },
                  "documentDigests": {
                    "type": "object",
                    "description": "",
                    "x-description-vi": "",
                    "properties": {
                      "hashes": {
                        "type": "array",
                        "description": "Base64 digests of the authorized content.",
                        "x-description-vi": "Digest Base64 của nội dung được cấp quyền.",
                        "items": {
                          "type": "string",
                          "description": "Value returned by the service.",
                          "x-description-vi": "Giá trị trong kết quả."
                        }
                      },
                      "hashAlgorithmOID": {
                        "type": "string",
                        "description": "Hash algorithm OID; select using confirmed configuration.",
                        "x-description-vi": "OID thuật toán băm; chọn theo cấu hình được xác nhận."
                      }
                    },
                    "required": [
                      "hashes",
                      "hashAlgorithmOID"
                    ]
                  },
                  "description": {
                    "type": "string",
                    "description": "User-facing authorization description.",
                    "x-description-vi": "Mô tả yêu cầu cho người dùng."
                  },
                  "agreementUUID": {
                    "type": "string",
                    "description": "Client-data correlation identifier in the source.",
                    "x-description-vi": "Mã liên kết clientData theo nguồn."
                  },
                  "username": {
                    "type": "string",
                    "description": "Username in the authorization context.",
                    "x-description-vi": "Tên người dùng theo ngữ cảnh cấp quyền."
                  },
                  "clientInfo": {
                    "type": "object",
                    "description": "",
                    "x-description-vi": "",
                    "properties": {
                      "application": {
                        "type": "string",
                        "description": "Originating application name.",
                        "x-description-vi": "Tên ứng dụng khởi tạo."
                      }
                    },
                    "required": []
                  },
                  "view": {
                    "type": "object",
                    "description": "",
                    "x-description-vi": "",
                    "properties": {
                      "lang": {
                        "type": "string",
                        "description": "View language.",
                        "x-description-vi": "Ngôn ngữ giao diện.",
                        "enum": [
                          "VI",
                          "EN"
                        ]
                      },
                      "callbackUrl": {
                        "type": "string",
                        "description": "Registered callback URL.",
                        "x-description-vi": "URL callback đã đăng ký.",
                        "format": "uri"
                      },
                      "redirectUrl": {
                        "type": "string",
                        "description": "Registered redirect URL.",
                        "x-description-vi": "URL chuyển hướng đã đăng ký.",
                        "format": "uri"
                      },
                      "fontSize": {
                        "type": "string",
                        "description": "UI font-size configuration.",
                        "x-description-vi": "Cấu hình cỡ chữ giao diện."
                      },
                      "templateUiId": {
                        "type": "string",
                        "description": "UI template identifier.",
                        "x-description-vi": "Mã mẫu giao diện."
                      },
                      "expiresIn": {
                        "type": "integer",
                        "description": "Units/meaning require confirmation; no default provided.",
                        "x-description-vi": "Đơn vị/ý nghĩa cần xác nhận; không cung cấp mặc định."
                      }
                    },
                    "required": []
                  }
                },
                "required": [
                  "credentialID",
                  "numSignatures",
                  "documentDigests"
                ]
              },
              "example": {
                "credentialID": "DEMO_SIC_CREDENTIAL",
                "numSignatures": 1,
                "documentDigests": {
                  "hashes": [
                    "ypeBEsobvcr6wjGzmiPcTaeG7/gUfE5yuYB3ha/uSLs="
                  ],
                  "hashAlgorithmOID": "2.16.840.1.101.3.4.2.1"
                }
              }
            }
          }
        },
        "parameters": [],
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.260928",
            "physicalPages": [
              30,
              31
            ]
          },
          "blocking_issues": [
            "SIC-02",
            "SIC-07"
          ],
          "response_model": "selected-fields"
        },
        "x-coverage": "selected-fields"
      }
    },
    "/v2/credentials/authorizeCheck": {
      "post": {
        "operationId": "sicAuthorizeCheck",
        "tags": [
          "SIC"
        ],
        "summary": "Read authorization outcome",
        "x-summary-vi": "Tra cứu cấp quyền",
        "description": "Read authorization outcome. Documentary extraction; not a validated production contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.260928",
          "physicalPages": [
            32,
            33
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-issues": [
          "SIC-02",
          "SIC-06",
          "SIC-09"
        ],
        "x-next-vi": "Chỉ chuyển sang ký khi đã nhận dữ liệu cấp quyền hợp lệ theo contract.",
        "x-next-en": "Proceed only after obtaining valid authorization data under the contract.",
        "responses": {
          "200": {
            "description": "Response described by the source; inspect business outcome separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "x-description-vi": "",
                  "properties": {
                    "SAD": {
                      "type": "string",
                      "description": "Signature Activation Data associated with the authorized content under the contract.",
                      "x-description-vi": "Dữ liệu cấp quyền ký; gắn với nội dung đã được cấp quyền theo contract."
                    },
                    "credentialID": {
                      "type": "string",
                      "description": "Credential identifier for the operation.",
                      "x-description-vi": "Identifier credential dùng cho operation."
                    },
                    "expiresIn": {
                      "type": "integer",
                      "description": "SAD lifetime in seconds in this table.",
                      "x-description-vi": "Thời hạn SAD tính bằng giây theo bảng này."
                    },
                    "token": {
                      "type": "string",
                      "description": "If present, the source says processing continues; conditional field presence needs confirmation.",
                      "x-description-vi": "Nếu có, nguồn mô tả giao dịch còn xử lý; điều kiện các trường cần xác nhận."
                    }
                  },
                  "required": []
                }
              }
            },
            "headers": {
              "x-billcode-id": {
                "description": "Service-generated tracking reference; persist with the local request.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "Service error fields. Exact status/code mapping requires the operation-specific deployment contract.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Error fields are conditional on the operation.",
                  "x-description-vi": "Đối tượng lỗi; trường xuất hiện theo operation.",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Service error code, distinct from HTTP status.",
                      "x-description-vi": "Mã lỗi theo dịch vụ; không phải HTTP status."
                    },
                    "message": {
                      "type": "string",
                      "description": "Short error message.",
                      "x-description-vi": "Thông báo lỗi ngắn."
                    },
                    "description": {
                      "type": "string",
                      "description": "Detailed explanation when present.",
                      "x-description-vi": "Mô tả chi tiết nếu có."
                    }
                  },
                  "required": []
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request fields transcribed from source tables.",
                "x-description-vi": "Cấu trúc request được biên tập từ bảng nguồn.",
                "properties": {
                  "token": {
                    "type": "string",
                    "description": "Token returned by the preceding step; do not publish it.",
                    "x-description-vi": "Token của bước trước; không ghi vào log công khai."
                  }
                },
                "required": [
                  "token"
                ]
              },
              "example": {
                "token": "DEMO_AUTHORIZATION_TOKEN"
              }
            }
          }
        },
        "parameters": [],
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.260928",
            "physicalPages": [
              32,
              33
            ]
          },
          "blocking_issues": [
            "SIC-02",
            "SIC-06",
            "SIC-09"
          ],
          "response_model": "selected-fields"
        },
        "x-coverage": "selected-fields"
      }
    },
    "/v2/signatures/signHash": {
      "post": {
        "operationId": "sicSignHash",
        "tags": [
          "SIC"
        ],
        "summary": "Sign authorized hashes",
        "x-summary-vi": "Ký hash đã cấp quyền",
        "description": "Sign authorized hashes. Documentary extraction; not a validated production contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.260928",
          "physicalPages": [
            36,
            37,
            38
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-issues": [
          "SIC-02",
          "SIC-04",
          "SIC-10"
        ],
        "x-next-vi": "Nhận chữ ký hoặc handle theo chế độ đã xác nhận; hoàn thiện và kiểm chứng tài liệu.",
        "x-next-en": "Receive signatures or a handle under the confirmed mode, then assemble and validate the document.",
        "responses": {
          "200": {
            "description": "Response described by the source; inspect business outcome separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "x-description-vi": "",
                  "properties": {
                    "signatures": {
                      "type": "array",
                      "description": "Base64 signatures when completed.",
                      "x-description-vi": "Chữ ký Base64 khi hoàn tất.",
                      "items": {
                        "type": "string",
                        "description": "Value returned by the service.",
                        "x-description-vi": "Giá trị trong kết quả."
                      }
                    },
                    "responseID": {
                      "type": "string",
                      "description": "Signing outcome handle; see the source example conflict with requestID.",
                      "x-description-vi": "Handle theo dõi kết quả ký; xem mâu thuẫn requestID trong ví dụ nguồn."
                    }
                  },
                  "required": []
                }
              }
            },
            "headers": {
              "x-billcode-id": {
                "description": "Service-generated tracking reference; persist with the local request.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "Service error fields. Exact status/code mapping requires the operation-specific deployment contract.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Error fields are conditional on the operation.",
                  "x-description-vi": "Đối tượng lỗi; trường xuất hiện theo operation.",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Service error code, distinct from HTTP status.",
                      "x-description-vi": "Mã lỗi theo dịch vụ; không phải HTTP status."
                    },
                    "message": {
                      "type": "string",
                      "description": "Short error message.",
                      "x-description-vi": "Thông báo lỗi ngắn."
                    },
                    "description": {
                      "type": "string",
                      "description": "Detailed explanation when present.",
                      "x-description-vi": "Mô tả chi tiết nếu có."
                    }
                  },
                  "required": []
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request fields transcribed from source tables.",
                "x-description-vi": "Cấu trúc request được biên tập từ bảng nguồn.",
                "properties": {
                  "credentialID": {
                    "type": "string",
                    "description": "Credential identifier for the operation.",
                    "x-description-vi": "Identifier credential dùng cho operation."
                  },
                  "SAD": {
                    "type": "string",
                    "description": "Signature Activation Data associated with the authorized content under the contract.",
                    "x-description-vi": "Dữ liệu cấp quyền ký; gắn với nội dung đã được cấp quyền theo contract."
                  },
                  "hashes": {
                    "type": "array",
                    "description": "Authorized digests; do not change the content.",
                    "x-description-vi": "Digest đã được cấp quyền; giữ đúng nội dung.",
                    "items": {
                      "type": "string",
                      "description": "Value returned by the service.",
                      "x-description-vi": "Giá trị trong kết quả."
                    }
                  },
                  "hashAlgorithmOID": {
                    "type": "string",
                    "description": "Hash algorithm OID; select using confirmed configuration.",
                    "x-description-vi": "OID thuật toán băm; chọn theo cấu hình được xác nhận."
                  },
                  "signAlgo": {
                    "type": "string",
                    "description": "Signature algorithm OID, mandatory in the table but absent in its example.",
                    "x-description-vi": "OID thuật toán ký; bắt buộc trong bảng, thiếu ở ví dụ nguồn."
                  },
                  "operationMode": {
                    "type": "string",
                    "description": "A: asynchronous; S: synchronous, default S in signHash. Do not apply this default to issue.",
                    "x-description-vi": "A: bất đồng bộ; S: đồng bộ, mặc định S ở phần signHash. Không áp dụng mặc định này sang issue.",
                    "enum": [
                      "A",
                      "S"
                    ],
                    "default": "S"
                  },
                  "clientInfo": {
                    "type": "object",
                    "description": "",
                    "x-description-vi": "",
                    "properties": {
                      "application": {
                        "type": "string",
                        "description": "Originating application name.",
                        "x-description-vi": "Tên ứng dụng khởi tạo."
                      }
                    },
                    "required": []
                  },
                  "validityPeriod": {
                    "type": "integer",
                    "description": "Outcome retention duration in milliseconds according to the table.",
                    "x-description-vi": "Thời hạn lưu kết quả tính bằng mili giây theo bảng."
                  }
                },
                "required": [
                  "credentialID",
                  "SAD",
                  "hashes",
                  "hashAlgorithmOID",
                  "signAlgo"
                ]
              },
              "example": {
                "credentialID": "DEMO_SIC_CREDENTIAL",
                "SAD": "DEMO_SAD_NOT_A_SECRET",
                "hashes": [
                  "ypeBEsobvcr6wjGzmiPcTaeG7/gUfE5yuYB3ha/uSLs="
                ],
                "hashAlgorithmOID": "2.16.840.1.101.3.4.2.1",
                "signAlgo": "1.2.840.113549.1.1.11"
              }
            }
          }
        },
        "parameters": [],
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.260928",
            "physicalPages": [
              36,
              37,
              38
            ]
          },
          "blocking_issues": [
            "SIC-02",
            "SIC-04",
            "SIC-10"
          ],
          "response_model": "selected-fields"
        },
        "x-coverage": "selected-fields"
      }
    },
    "/v2/signatures/signPolling": {
      "post": {
        "operationId": "sicSignPolling",
        "tags": [
          "SIC"
        ],
        "summary": "Poll an asynchronous signing outcome",
        "x-summary-vi": "Tra cứu kết quả bất đồng bộ",
        "description": "Poll an asynchronous signing outcome. Documentary extraction; not a validated production contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.260928",
          "physicalPages": [
            38,
            39
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-issues": [
          "SIC-02",
          "SIC-08"
        ],
        "x-next-vi": "Chốt responseID hay requestID trước tích hợp; không tạo lại để thay polling.",
        "x-next-en": "Confirm responseID versus requestID before integration; polling does not mean recreating the request.",
        "responses": {
          "200": {
            "description": "Response described by the source; inspect business outcome separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "",
                  "x-description-vi": "",
                  "properties": {
                    "signatures": {
                      "type": "array",
                      "description": "Signatures returned when creation completes.",
                      "x-description-vi": "Chữ ký khi việc tạo chữ ký hoàn tất.",
                      "items": {
                        "type": "string",
                        "description": "Value returned by the service.",
                        "x-description-vi": "Giá trị trong kết quả."
                      }
                    }
                  },
                  "required": []
                }
              }
            },
            "headers": {
              "x-billcode-id": {
                "description": "Service-generated tracking reference; persist with the local request.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "Service error fields. Exact status/code mapping requires the operation-specific deployment contract.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Error fields are conditional on the operation.",
                  "x-description-vi": "Đối tượng lỗi; trường xuất hiện theo operation.",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Service error code, distinct from HTTP status.",
                      "x-description-vi": "Mã lỗi theo dịch vụ; không phải HTTP status."
                    },
                    "message": {
                      "type": "string",
                      "description": "Short error message.",
                      "x-description-vi": "Thông báo lỗi ngắn."
                    },
                    "description": {
                      "type": "string",
                      "description": "Detailed explanation when present.",
                      "x-description-vi": "Mô tả chi tiết nếu có."
                    }
                  },
                  "required": []
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request fields transcribed from source tables.",
                "x-description-vi": "Cấu trúc request được biên tập từ bảng nguồn.",
                "properties": {
                  "responseID": {
                    "type": "string",
                    "description": "Signing outcome handle; see the source example conflict with requestID.",
                    "x-description-vi": "Handle theo dõi kết quả ký; xem mâu thuẫn requestID trong ví dụ nguồn."
                  }
                },
                "required": [
                  "responseID"
                ]
              },
              "example": {
                "responseID": "DEMO_SIGN_RESPONSE"
              }
            }
          }
        },
        "parameters": [],
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.260928",
            "physicalPages": [
              38,
              39
            ]
          },
          "blocking_issues": [
            "SIC-02",
            "SIC-08"
          ],
          "response_model": "selected-fields"
        },
        "x-coverage": "selected-fields"
      }
    },
    "/v2/credentials/info": {
      "post": {
        "operationId": "sicCredentialInfo",
        "tags": [
          "SIC"
        ],
        "summary": "Read credential information",
        "x-summary-vi": "Đọc thông tin credential",
        "description": "Read credential information. Documentary extraction; not a validated production contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.260928",
          "physicalPages": [
            26,
            27,
            28,
            29
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-issues": [
          "SIC-02",
          "SIC-12"
        ],
        "x-next-vi": "Đối chiếu credential, chứng thư và cơ chế cấp quyền trước ký.",
        "x-next-en": "Check credential, certificate and authorization mechanisms before signing.",
        "responses": {
          "200": {
            "description": "Response described by the source; inspect business outcome separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Object from source tables.",
                  "x-description-vi": "Đối tượng theo bảng nguồn.",
                  "properties": {
                    "description": {
                      "type": "string",
                      "description": "Localized credential description, maximum 255 characters in the table.",
                      "x-description-vi": "Mô tả credential theo ngôn ngữ; tối đa 255 ký tự theo bảng.",
                      "maxLength": 255
                    },
                    "signatureQualifier": {
                      "type": "string",
                      "description": "Source signature qualifier.",
                      "x-description-vi": "Mã phân loại chữ ký theo nguồn."
                    },
                    "key": {
                      "type": "object",
                      "description": "Object from source tables.",
                      "x-description-vi": "Đối tượng theo bảng nguồn.",
                      "properties": {
                        "status": {
                          "type": "string",
                          "description": "Signing-key status.",
                          "x-description-vi": "Trạng thái khóa ký.",
                          "enum": [
                            "enabled",
                            "disabled"
                          ]
                        },
                        "algo": {
                          "type": "array",
                          "description": "Supported key-algorithm OIDs.",
                          "x-description-vi": "Danh sách OID thuật toán khóa được hỗ trợ.",
                          "items": {
                            "type": "string",
                            "description": "Algorithm OID.",
                            "x-description-vi": "OID thuật toán."
                          }
                        },
                        "len": {
                          "type": "integer",
                          "description": "Key length in bits.",
                          "x-description-vi": "Độ dài khóa tính bằng bit."
                        },
                        "curve": {
                          "type": "string",
                          "description": "Curve OID, conditional on ECDSA in the table.",
                          "x-description-vi": "OID đường cong; chỉ khi khóa ECDSA theo bảng."
                        }
                      },
                      "required": [
                        "status",
                        "algo",
                        "len"
                      ]
                    },
                    "cert": {
                      "type": "object",
                      "description": "Object from source tables.",
                      "x-description-vi": "Đối tượng theo bảng nguồn.",
                      "properties": {
                        "status": {
                          "type": "string",
                          "description": "Certificate state when the response is generated; no enum inferred.",
                          "x-description-vi": "Trạng thái chứng thư tại thời điểm trả kết quả; không tự suy enum."
                        },
                        "certificates": {
                          "type": "array",
                          "description": "Base64 chain, conditional on certificates=none/single/chain.",
                          "x-description-vi": "Chuỗi chứng thư Base64; phụ thuộc certificates=none/single/chain.",
                          "items": {
                            "type": "string",
                            "description": "Base64 certificate.",
                            "x-description-vi": "Chứng thư Base64."
                          }
                        },
                        "issuerDN": {
                          "type": "string",
                          "description": "UTF-8 issuer DN under RFC 4514 when certificate information is requested.",
                          "x-description-vi": "Issuer DN UTF-8 theo RFC 4514 khi yêu cầu thông tin chứng thư."
                        },
                        "serialNumber": {
                          "type": "string",
                          "description": "Hex serial number when certInfo=true.",
                          "x-description-vi": "Số sê-ri dạng hex khi certInfo=true."
                        },
                        "subjectDN": {
                          "type": "string",
                          "description": "UTF-8 subject DN under RFC 4514 when certificate information is available.",
                          "x-description-vi": "Subject DN UTF-8 theo RFC 4514 khi có thông tin chứng thư."
                        },
                        "validFrom": {
                          "type": "string",
                          "description": "Validity start encoded as GeneralizedTime in the source.",
                          "x-description-vi": "Ngày bắt đầu theo GeneralizedTime trong nguồn."
                        },
                        "validTo": {
                          "type": "string",
                          "description": "Validity end encoded as GeneralizedTime in the source.",
                          "x-description-vi": "Ngày kết thúc theo GeneralizedTime trong nguồn."
                        }
                      },
                      "required": []
                    },
                    "auth": {
                      "type": "object",
                      "description": "Object from source tables.",
                      "x-description-vi": "Đối tượng theo bảng nguồn.",
                      "properties": {
                        "mode": {
                          "type": "string",
                          "description": "Returned authorization mechanism; no scopes inferred.",
                          "x-description-vi": "Cơ chế cấp quyền được trả về; không suy scope.",
                          "enum": [
                            "explicit",
                            "oauth2code"
                          ]
                        },
                        "expression": {
                          "type": "string",
                          "description": "Expression combining authentication objects.",
                          "x-description-vi": "Biểu thức kết hợp các đối tượng xác thực."
                        },
                        "objects": {
                          "type": "object",
                          "description": "Object from source tables.",
                          "x-description-vi": "Đối tượng theo bảng nguồn.",
                          "properties": {},
                          "required": []
                        }
                      },
                      "required": []
                    },
                    "SCAL": {
                      "type": "string",
                      "description": "1: source describes no hash/SAD binding; 2: binding present. Check actual configuration.",
                      "x-description-vi": "1: nguồn mô tả không liên kết hash với SAD; 2: có liên kết. Đối chiếu cấu hình thực tế.",
                      "enum": [
                        "1",
                        "2"
                      ]
                    },
                    "multisign": {
                      "type": "string",
                      "description": "Table specifies String; example uses a number. Confirm the type. Value represents maximum signatures.",
                      "x-description-vi": "Bảng ghi String, ví dụ ghi số; kiểu dữ liệu cần xác nhận. Giá trị biểu diễn số chữ ký tối đa."
                    },
                    "lang": {
                      "type": "string",
                      "description": "Response language.",
                      "x-description-vi": "Ngôn ngữ trong kết quả."
                    }
                  },
                  "required": [
                    "key",
                    "multisign"
                  ]
                }
              }
            },
            "headers": {
              "x-billcode-id": {
                "description": "Service-generated tracking reference; persist with the local request.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "Service error fields. Exact status/code mapping requires the operation-specific deployment contract.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Error fields are conditional on the operation.",
                  "x-description-vi": "Đối tượng lỗi; trường xuất hiện theo operation.",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Service error code, distinct from HTTP status.",
                      "x-description-vi": "Mã lỗi theo dịch vụ; không phải HTTP status."
                    },
                    "message": {
                      "type": "string",
                      "description": "Short error message.",
                      "x-description-vi": "Thông báo lỗi ngắn."
                    },
                    "description": {
                      "type": "string",
                      "description": "Detailed explanation when present.",
                      "x-description-vi": "Mô tả chi tiết nếu có."
                    }
                  },
                  "required": []
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request fields transcribed from source tables.",
                "x-description-vi": "Cấu trúc request được biên tập từ bảng nguồn.",
                "properties": {
                  "credentialID": {
                    "type": "string",
                    "description": "Credential identifier for the operation.",
                    "x-description-vi": "Identifier credential dùng cho operation."
                  },
                  "certificates": {
                    "type": "string",
                    "description": "Certificate-chain return selection.",
                    "x-description-vi": "Mức trả về chuỗi chứng thư.",
                    "enum": [
                      "none",
                      "single",
                      "chain"
                    ],
                    "default": "single"
                  },
                  "certInfo": {
                    "type": "boolean",
                    "description": "Request certificate details.",
                    "x-description-vi": "Yêu cầu thông tin chứng thư."
                  },
                  "lang": {
                    "type": "string",
                    "description": "Language in the credential-information table; no enum stated.",
                    "x-description-vi": "Ngôn ngữ theo bảng thông tin credential; enum chưa được nêu."
                  },
                  "authInfo": {
                    "type": "boolean",
                    "description": "Request authorization-mechanism details.",
                    "x-description-vi": "Yêu cầu thông tin cơ chế cấp quyền."
                  }
                },
                "required": [
                  "credentialID"
                ]
              },
              "example": {
                "credentialID": "DEMO_SIC_CREDENTIAL",
                "certificates": "chain",
                "certInfo": true
              }
            }
          }
        },
        "parameters": [],
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.260928",
            "physicalPages": [
              26,
              27,
              28,
              29
            ]
          },
          "blocking_issues": [
            "SIC-02",
            "SIC-12"
          ],
          "response_model": "selected-fields"
        },
        "x-coverage": "selected-fields"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-catalog": [
    [
      "Auth login",
      "POST",
      "/v2/auth/login",
      7
    ],
    [
      "Auth revoke",
      "POST",
      "/v2/auth/revoke",
      9
    ],
    [
      "Providers",
      "POST",
      "/v2/credentials/providers",
      10
    ],
    [
      "Signing package: packageInfo",
      "POST",
      "/v2/credentials/providers",
      10
    ],
    [
      "Issue",
      "POST",
      "/v2/credentials/issue",
      15
    ],
    [
      "Issue check",
      "POST",
      "/v2/credentials/issueCheck",
      19
    ],
    [
      "List",
      "POST",
      "/v2/credentials/list",
      21
    ],
    [
      "Information",
      "POST",
      "/v2/credentials/info",
      26
    ],
    [
      "Authorize",
      "POST",
      "/v2/credentials/authorize",
      30
    ],
    [
      "Authorize check",
      "POST",
      "/v2/credentials/authorizeCheck",
      32
    ],
    [
      "Credential history",
      "POST",
      "/v2/credentials/history",
      33
    ],
    [
      "Sign hash",
      "POST",
      "/v2/signatures/signHash",
      36
    ],
    [
      "Sign polling",
      "POST",
      "/v2/signatures/signPolling",
      38
    ],
    [
      "Signing history",
      "POST",
      "/v2/signatures/history",
      39
    ],
    [
      "Owner management",
      "POST",
      "/v2/owner/management",
      42
    ]
  ]
}