Getting Started
Transactions
Information
Before going through this section, please check the Billing agreement section here.
This functionality allows you to initiate a deposit of funds from a user who has already set up a Billing agreement, without the need for the user to log in, thus no redirect is necessary.
OneClick payment can be set up when creating a payment using either the one-step (regular/simple) or two-step method.
After creating the initial agreement with the ‘createBillingagreement=true’ parameter, Luxon will send you the ‘bilingAgreementID’ via a webhook. You should store this ID for subsequent user deposits.
Note that a OneClick payment requires that the user has enough Luxon balance in the desired currency. Having insufficient balance will incur an error response:
"status":{
"code":"insufficient.balance",
"message": "Insufficient balance. Please decrease the amount.",
"detail": null
}
If the balance is insufficient, you’ll receive an error response and you should redirect the user back to the cashier with a prompt to top up their Luxon wallet.
Request Parameters
| Name | Type | Description |
| merchantTransactionId | String | A Unique ID to identify the transaction. |
| merchantUserId | String | A unique ID to identify the user. |
| redirectUrl | String | The URL we redirect the customer to after the payment is completed. |
| comment | String | A text comment that accompanies the deposit (visible to the user and merchant). |
| amount | Integer | A positive integer in cents represents how much the user wishes to deposit.
e.g. 100 EUR would be 10000 / 50 USD would be 5000 |
| currency | String | The ISO 3 letter currency code in lowercase, see the supported currency list for details. |
| billingAgreementId | String | A unique Luxon billing agreement identifier that can be used to create transactions on behalf of the user.
This ID is generated on a previous deposit and must be stored by the merchant. |
| brand | String | An optional string that can be used to send identifying information for the merchant to allow grouping of transactions. |
| useBrand | Boolean | An optional boolean that will replace the merchant name registered with Luxon with text sent in the brand field in the user payment confirmation screen. |
{
"merchantTransactionId": "string",
"merchantUserId": "string",
"redirectUrl": "string",
"comment": "string",
"amount": number,
"currency": "String",
"billingAgreementId": "string",
"brand" : "string",
"useBrand": Boolean
}
{
"amount": 50000,
"redirectUrl": "https",
"useBrand": false,
"merchantTransactionId": 648513721,
"billingAgreementId": "62SQ***vZM",
"comment": null,
"currency": "USD",
"merchantUserId": 876226,
"recipientWallet": null,
"createBillingAgreement": false,
"brand": null
}
Same as the Simple Payment
Scroll to top