Integrate GovSign in any language

// npm install @govsign/sdk
import { GovSign } from "@govsign/sdk";
const gov = new GovSign({ baseUrl: "https://api.govsign.gov.np", clientId, hmacSecret: process.env.GOVSIGN_SECRET });

const signed = await gov.signatures.signPdf({
  pdf:          kycPdf,
  citizenId:    "12-34-56-7890",
  title:        "Account Opening — KYC",
  relyingParty: "NIBL Bank",
  level:        "LT",
});
// signed: Uint8Array — a PAdES-LT signed PDF

# pip install govsign
from govsign import GovSign
gov = GovSign(base_url="https://api.govsign.gov.np", client_id=client_id, hmac_secret=secret)

signed = gov.signatures.sign_pdf(
    pdf=claim_pdf,
    citizen_id="12-34-56-7890",
    title="Insurance claim #4821",
    relying_party="Nepal Life Insurance",
    level="LT",
)
# signed: bytes — PAdES-LT PDF

// np.gov.govsign:govsign-sdk:1.0.9
var gov = new GovSign("https://api.govsign.gov.np", clientId, hmacSecret);

byte[] signed = gov.signatures().signPdf(SignPdfRequest.builder()
    .pdf(pdfBytes)
    .citizenId("12-34-56-7890")
    .title("Loan application")
    .relyingParty("NIBL Bank")
    .level("LT")
    .build());

// go get github.com/govnp/govsign-go
gov := govsign.New("https://api.govsign.gov.np", clientID, hmacSecret)

signed, err := gov.Signatures.SignPdf(ctx, govsign.SignPdfRequest{
    Pdf:          pdfBytes,
    CitizenID:    "12-34-56-7890",
    Title:        "Tax clearance certificate",
    RelyingParty: "Inland Revenue Dept",
    Level:        "LT",
})

// composer require govsign/sdk
use GovSign\GovSign;
$gov = new GovSign("https://api.govsign.gov.np", $clientId, $secret);

$signed = $gov->signatures->signPdf([
    "pdf"          => $pdfBytes,
    "citizenId"    => "12-34-56-7890",
    "title"        => "Land registration deed",
    "relyingParty" => "Land Revenue Office",
    "level"        => "LT",
]);

results = gov.signatures.sign_pdf_batch(
    citizen_id="12-34-56-7890",
    title="Quarterly filing — 4 forms",
    relying_party="eBPS",
    items=[{"pdf": f1}, {"pdf": f2}, {"pdf": f3}, {"pdf": f4}],
)

List<byte[]> results = gov.signatures().signPdfBatch(BatchRequest.builder()
    .citizenId("12-34-56-7890")
    .title("Quarterly filing")
    .relyingParty("eBPS")
    .add(form1).add(form2).add(form3)
    .build());

var results = await gov.Signatures.SignPdfBatchAsync(new BatchRequest {
    CitizenId    = "12-34-56-7890",
    Title        = "Quarterly filing",
    RelyingParty = "eBPS",
    Items        = { form1, form2, form3, form4 }
});

const result = await gov.signatures.signPdfInstitutional({
  certReference: "ird-bulk-stamp-2026",
  level:         "LT",
  reason:        "Tax clearance",
  items:         batch.map(pdf => ({ pdf })),
});
result.signedItems.forEach(i => save(i.filename, i.signedPdfB64));

var result = gov.signatures().signPdfInstitutional(InstitutionalRequest.builder()
    .certReference("ird-bulk-stamp-2026")
    .level("LT").reason("Tax clearance")
    .items(batch)
    .build());

result, err := gov.Signatures.SignPdfInstitutional(ctx, govsign.InstitutionalRequest{
    CertReference: "ird-bulk-stamp-2026",
    Level:         "LT",
    Reason:        "Tax clearance",
    Items:         items,
})

session = gov.signatures.create_connect_session(
    document_digest=sha256(pdf),
    title="Pension verification",
    relying_party="Pension Management Office",
)
render_qr(session.deeplink)
show_code(session.verification_code)

report = gov.validations.validate(signed_pdf)
if report.valid:
    for s in report.signatures:
        print(s.signer, s.indication, s.ocsp_status)

curl -X POST https://api.govsign.gov.np/api/v1/validate/auto \
  -H "authorization: HMAC <clientId>:<ts>:<nonce>:<sig>" \
  --data-binary @signed.pdf

@app.post("/webhooks/govsign")
def hook():
    gov.webhooks.verify(request.data, request.headers["X-GovSign-Signature"], webhook_secret)
    evt = request.get_json()
    if evt["type"] == "SIGNING_COMPLETED":
        mark_signed(evt["sessionId"])
    return "", 200

gov.webhooks().verify(rawBody, request.getHeader("X-GovSign-Signature"), webhookSecret);
// throws on bad signature / clock skew; otherwise proceed

$gov->webhooks->verify($rawBody, $_SERVER["HTTP_X_GOVSIGN_SIGNATURE"], $webhookSecret);