Multi Address Payments RELEASED4 years, 2 months ago
We've performed our scheduled maintenance, and we're monitoring our system closely and it's all going well! Finally you can choose if keep collecting your payments into a single address or in multiple addresses! As already anticipated, this change will be backward-compatible, which means that nothing will change and you won't need to change anything if you want to receive your payments in only 1 address. No new settings are needed for who don't want to use the "MULTI-ADDRESS" feature (if you are already using CryptAPI, you do NOT need to change any setting!). If you want to use the MULTI-ADDRESS feature you just need to add few lines to your actual settings: https://cryptapi.io/api/btc/create/?address=percentage1@btcaddress1|percentage2@btcaddress2|percentage3@btcaddress3&callback=http://example.com/callback?invoice=1234 Where "percentage" it the % to be sent to a specific address and "btcaddress" the the specific BTC address where you want to collect the money. Let's guess you want to split your payments like this example (the example is for BTC request, but the syntax is the same for ALL the coins managed by CryptAPI): 30% to 1Eq4eoACetX2ehV5FKf1Kw6SWScSpt859f 20% to 17zFVZVZWA9UCz7KpQCpNu75R6dgAHhFPz 50% to 1PM67s4sNRb6jeEGWmtJkgMMR31EWhrMnr then the request should be written like this: https://cryptapi.io/api/btc/create/?address=0.30@1Eq4eoACetX2ehV5FKf1Kw6SWScSpt859f|0.20@17zFVZVZWA9UCz7KpQCpNu75R6dgAHhFPz|0.50@1PM67s4sNRb6jeEGWmtJkgMMR31EWhrMnr&callback=http://example.com/callbackmultiaddresstest?invoice=1234 That's it! NOTE: - the sum of all "percentages" values of a single request must be equal to 1 (100%)! - for Bitcoin, Bitcoin Cash and Litecoin transactions, you'll need to make sure each payment is at least 546 satoshi, or it will be disregarded. This does not apply to the other currencies (ETH, XMR and IOTA)
- The minimum transaction value, shown here, will be multiplied by the number of addresses you set. This will mean, for instance, that a Bitcoin transaction with 2 addresses will have a minimum TX value of 0.0004 BTC, instead of 0.0002 BTC. This is because of the network fees, as fees will rise with the amount of addresses you set. Fees will not be affected by how many addresses you set.
- Percentages will be set from 0.01 (1%) to 1.00 (100%) and be rounded to 2 decimal places (e.g 0.15 / 0.85 in the example above). If the sum of the percentages is not equal to 1.00 (100%), an error will be given.
- If only 1 address is set (as it is now), then it is considered to receive 100% of the value of the transactions, exactly the same as the current behaviour, so it won't break compatibility.