Potapay(English)
    • Interface description
    • appoint
    • Signature & Signature Algorithm
    • Test parameter
    • Error code
    • v1
      • Create invoice order
        POST
      • Create a payment order
        POST
      • Order inquiry
        POST
      • Account balance inquiry
        POST
      • Certificate query
        POST
    • v2
      • Mexico
        • List of Mexican banks
        • Test parameters
        • Query
          • Order Inquiry
          • Account Balance Inquiry
          • Voucher Inquiry
        • Create a invioce order
        • Create a payment order
      • Brazil
        • Create invioce order
        • Create payment order - no query restrictions
        • Create payment order
        • Order inquiry
        • Account balance inquiry
        • Certificate query
    • webhook Request
      POST
    • Schemas
      • payin parameters
      • payin parameters v2
      • payout parameters
      • order query
      • balance query
      • webhook
      • proof query
      • payout manual

    Interface description

    The reader of this article：#

    Technical architects, R&D engineers, and system operation and maintenance engineers who use the Potawallet merchant service system. Through this document, merchants can understand Potawallet's access technology, access product services, access processes, access specifications, and other information, so that merchants can successfully complete the access work

    Order creation process:#

    image.png

    Order webhook process:#

    image.png
    1.
    How do you get your key (public and private key)?
    ## Private key
openssl genpkey -algorithm RSA -out private.pem -pkeyopt rsa_keygen_bits:4096
# Public key
openssl rsa -pubout -in private.pem -out public_key.pem
# Private key in pkcs8 format (for Java maybe)
openssl pkcs8 -topk8 -in private.pem -out private_key.pem
    image.png
    Or online generation
    https://acte.ltd/utils/openssl
    Select 4096 key length and PKCS#8 key format
    image.png
    1.How to upload your public key
    Upload path as shown：
    image.png
    Click to view, you can see our certificate management box (as shown below)
    The platform public key of pota can be viewed on this page
    If you generated your own key, you will need to upload your public key to the merchant public key in this box
    If you do not have the key, you can click 【Generate Certificate】 button, after generating the public key and private key we generated for you will be displayed in the pop-up box. After generating the public key, you need to click "Upload public key" to upload the public key to the system. For the security of your funds, we will not save your private key, and after closing this pop-up box, the private key will be cleared.
    image.png
    4.
    How do you get youruuid
    The uuid（Wallet account） of a merchant account can be viewed in Money Management
    image.png
    After the merchant's public key has been uploaded, order creation can begin
    Modified at 2026-02-10 13:48:37
    Next
    appoint
    Built with