Automatic channel payment enrollment

When you create a channel, you set a currency pair for it, meaning you get to choose the currency that the user sends and the currency that will be credited to your account. But occasionally a user can make a mistake and send some third currency e.g. when USDT via TRC-20 is sent instead of TRX via TRC-20 etc. Channel payments with incorrect coin (but correct network) are credited automatically as channel payments (with Custom ID of the original channel), and callbacks are sent.

Important points: • The feature is only available if the user has sent incorrect coin via the correct network. If the network or both network and coin are incorrect, you can check the possibility of recovery here.

• The feature is only available for channels; it isn’t supported for invoices.

• In such cases (when the end-user used an incorrect currency), paid_currency for channel payment (in the callback) will differ from pay_currency of the channel itself for those incorrect coin payments (it will match the actual currency that was sent and received on our side, as long as it’s supported by us). To ensure that such payments are credited correctly on your side, please check whether your integration would supports such a mismatch between the channel data and the callback;

• The received_currency (from the callback) will be the same as the receiver_currency of the original channel, so if the end-user expected to get e.g. EUR as a result, this is the currency they’ll be credited with;

• Even if the channel initially has pay_currency = receiver_currency (crediting payments with no exchange), with an incorrect coin there will be an exchange to receiver_currency (so the current exchange rates would apply);