Payments
Once you have an account and a payment form, you can start using our API to create payments.
When you create a payment, the API will return a unique URL that your customer can use to see your form and pay the amount you choose.
Payments are secured and are done on the blockchain for maximum security.
When you create a Payonix account, we generate addresses on the blockchains we support. These addresses are where you will receive the transactions.
You cannot change the addresses the payments go to but you can withdraw your crypto to another address whenever you want.
To create a payment, you will need the API key of your account and the ID of the payment form you want to create a payment in.
When creating a payment through the API, you can choose:
- The payment form you want to create
- The cost in USD so when the user chooses the token he wants to pay with, the amount he needs to pay in that token will be calculated with the cost in USD you choose
- The name(s) of the product(s) that the user is buying (will be displayed in the payment page)
- The product(s) image(s) that the user is buying (displayed in the payment page)
- The URLs to redirect the user to when the payment is completed or canceled
- An endpoint that the app will send a request to when the payment is completed and the data you want the app to send (the payment data will always be sent, but you can add your own custom information)
You can then see all the payments associated with each payment form in the merchant section of the dashboard.
In the merchant section when you select a payment form, you can see graphics representing your sales for the periods you select and you can see the full list of payments you received and download it.
In the near future, you will also be able to refund a payment, we are working on it.
Payments can have the following status:
- Initialized (when you just created it and the user didn’t open the payment page)
- Canceled (the user opened the payment page and did not pay)
- Pending (the user paid and the transaction is pending)
- Completed (the user paid and the transaction is completed)
- Completed with failed call to webhook (the user paid and the transaction is completed but the API call to your webhook returned an error)
- Failed (the user paid but the transaction failed)
