Developers/Business Client (Integrator)

What browsers are supported by the Business Client management screen?

To become a Nodex Pay Business Client, we currently require Google Chrome, Brave, or Firefox on your PC or Mac. You must also have the MetaMask Extension installed on your browser. Safari does not support because the MetaMask Extension does not exist.

If you have already installed the MetaMask app on your mobile device or tablet, you may be able to open a Business Client account from by using the browser in the MetaMask app. However, for design reasons, we recommend that you open a Business Client account from a PC.

Nodex Pay completes quickly, does it take reorg impact into account?

As of Jan 19, 2023, Nodex Pay does not take blockchain reorg into account and assumes payment is complete when tx is confirmed in the longest block. Therefore, the time to complete settlement is very short. On the other hand, there is a very rare case that the transaction may revert back to incomplete after the settlement is completed. Because it is so rare, at the time of writing, we have never experienced such an event with Nodex Pay. We plan to implement a reorg-aware payment method in the future. At this time, we are asking that payment rewind due to reorg be resolved through negotiation between the payer and Business Client at this time.

What does each status in History mean?

status	description
System Received	Created payment URL
Wallet Confirming	Payer is confirming the On-chain transaction. (Payer clicked the Pay button, but still not approve the transaction)
Result Pending	Payer approved the On-chain transation
Completed	On-chain transaction and payment is completed
Cancelled	Invalid transaction. The payment has failed due to invalid transaction or incorrect payment amount

What are the reasons for settlement failures?

• Blockchain Network is out of service

  • The network itself may be out of service, as Nodex Pay is guaranteed to work only when the network is healthy by managing payments via smart contracts.

• Insufficient GAS

  • Depending on the state of the blockchain, GAS may soar.

• The amount of payment is not enough

  • Token price is volatile at any moment. Sometimes the volatility is unexpected high and exceeds estimated payment amount.

• The settlement expiration date has been exceeded

  • The settlement screen and smart contract determine whether the settlement expiration date has been exceeded.

Is there are time limit for users to complete payment after the settlement URL is generated?

There is time limit. The default is within one hour of receipt to the Payment Request API. Arbitrary time limits can be set by specifying a deadline in the request parameter of the Payment Request API.

Is there a way for users to view payment history and details?

Nodex Pay has no such future. If you wish to offer such a feature, it would be implemented by Business Client.

What is the unique key of settlement?

The following is unique keys. Use them as needed.

• order_code : It is generated by Business Client (Integrator)

• transaction_code : It is generated by Nodex Pay

• verify_token : It is generated using order_code

• payment_token : It is included in the return value of Payment Request API and used in the settlement URL. This value is the only one that Nodex Pay exposes that uniquely identifies the payment

• transaction_hash : It is generated and published on the blockchain.

How is counted 30 days as being available for Payment State Confirm API calls?

Counting starts in seconds from the time the payment URL is created and expires after 30 days.

Is there a timeout on API?

There isn't.

Is there a maximum or minimum spending limit per transaction?

There is no maximum spending limit.

There is no minimum spending limit. However, Payer will be charged GAS cost at the time of payment. The GAS cost in USD varies widely from network to network (in the worst case tens or hundreds of dollars for Ethereum, in some cases less than 0.000001 USD for ASTAR). Therefore, depending on the network, but most Business Clients charge a minimum of 1-5 USD.