Skip to content
Last updated

2. How to Integrate and Use Infini API

This chapter will guide you through the complete process from registering an account, configuring keys, to API integration and Webhook setup, helping you quickly start using Infini's digital currency payment capabilities.

Step 1: Register an Infini Business Account

After registration, you can log in to the merchant backend for further configuration.

Step 2: Configure Checkout Basic Information

Go to 「Payments -> Cashier Settings」 in the backend to configure the following according to business needs:

  • Merchant Display Name: Used to display the merchant or business line name on the payment page to improve user recognition. The initial default is the company name filled in during customer registration.

If a merchant display name is passed through the API when creating an order, the API parameter takes precedence; the backend configuration serves as the default value.

  • Default Order Expiration Time: Controls the valid payment time window for orders; orders not paid before expiration will be automatically marked as expired, and partially paid orders after expiration will be automatically marked as partial_paid. The initial default is 24 hours.

If expires_in is passed through the API when creating an order, the API parameter takes precedence; the backend configuration only serves as the default expiration time.

Step 3: Register your public key

Generate an Ed25519 key pair on your backend and upload only the public key on the Developer page. The console returns a 32-character Base58 Key ID. Keep the private key yourself; Infini never generates or displays it. Select permissions and configure your server egress IP allowlist. Follow Authentication for key formats and signing.

Step 4: Integrate API and Configure Webhook Notifications

  1. Complete API Integration
  • Generate an Ed25519 key pair, upload the public key in the console to obtain a Key ID, and follow the v2 signing guide.
  • Develop the following interfaces according to business processes:
    • Create Order
    • Query Order
  • It is recommended to debug in the test environment first, then switch to the production environment.
  1. Configure Webhook Notification Address
  • Fill in on the backend「Developer」page:
    • Webhook receiving URL
    • Subscribed event types
  • The page will display Infini's Webhook public key, used for HMAC signature verification of callback notifications to ensure the notification source is authentic and reliable.

Step 5: Use Website Builder Platform Plugins (In Development)

If you use mainstream website builder platforms, you can quickly integrate Infini through official plugins:

  • Go to 「Payments -> Usage Guide」 in the backend to view and download various website builder platform plugins.
  • Plugins provide one-click installation, allowing integration of payment capabilities without development.