BeaconX e-Invoice API
  1. B2B e-Invoicing
BeaconX e-Invoice API
  • BeaconX e-Invoice API Documentation
  • API Endpoints
    • B2B e-Invoicing
      • Create Document(s)
        POST
      • Cancel Document
        POST
      • Void Document
        POST
      • Unvoid Document
        POST
      • [Deprecate] Create Invoice from Receipt
        POST
      • Check Status
        POST
      • Embed QR Code
        POST
      • Invoice Reversal
        POST
      • Update Reference Number
        POST
    • B2C Receipt
      • Retrieve Receipt
      • Search Receipts
      • Create a Receipt
      • Update existing Receipt
      • Void a Receipt
      • Void Multiple Receipts
      • UnVoid a Receipt
      • Create Multiple Receipts (Bulk)
      • Receipt Reversal
      • Update Reference Number
      • Check Status
      • Get Validated Receipts
    • TaxPayer
      • Validate Tax Payer
      • [Deprecate] Sync Tax Payer Master List
      • Identity
      • Validate SSM
      • Search TIN
    • Lists
      • Get list of all Classification Codes
  • Schemas
    • Document
    • Receipt
    • Shipping
    • Supplier
    • TaxPayer
    • Refund
    • Buyer
    • Annex
    • LineItem
  1. B2B e-Invoicing

Embed QR Code

POST
/einvoices/{reference_number}/qr_embed
This endpoint allows source systems that does not have support for QR Code generation to embed QR code into the PDF invoice provided and returned to the source system via API.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Header Params

Body Params application/json

Example
{
    "pdf_file": "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

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://einvoice-api.beaconx.com.my/einvoices/BeaconX-1225002/qr_embed' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pdf_file": "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

Responses

🟢200Success
application/json
Body

Example
{
    "status": "OK",
    "message": "",
    "data": {
        "object": "YWR3d2R3YQ=="
    }
}
Modified at 2025-12-02 09:54:57
Previous
Check Status
Next
Invoice Reversal
Built with