@depay/widgets 6.12.1 → 6.15.0

package/README.md

@@ -194,6 +194,25 @@ DePayWidgets.Payment({
 });
 ```
 
+#### fromToken, fromAmount + toToken
+
+In case where you want to configure payments based on the source token + amount, rather than target token and amount, you can pass `fromToken`, `fromAmount` and `toToken` to `accept`.
+
+In those cases make sure to NOT configure `token` nor `amount`!
+
+```javascript
+DePayWidgets.Payment({
+  accept: [{
+    blockchain: 'bsc',
+    fromToken: '0xe9e7cea3dedca5984780bafc599bd69add087d56',
+    fromAmount: 0.1,
+    toToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+    receiver: '0x08B277154218CCF3380CAE48d630DA13462E3950'
+  }]
+});
+
+// This will open a payment widget to send 0.1 BUSD to the receiver, converting it to BNB along the way.
+```
 
 #### track
 
@@ -586,6 +605,29 @@ let { unmount } = await DePayWidgets.Payment({})
 unmount()
 ```
 
+#### recover
+
+`recover`
+
+Allows you to recover a previous made payment. E.g. useful if you need to continue to show a pending payment progress if user rearrives or reloads a payment page:
+
+```javascript
+DePayWidgets.Payment({
+  recover: {
+    blockchain: 'ethereum',
+    transaction: '0x081ae81229b2c7df586835e9e4c16aa89f8a15dc118fac31b7521477c53ed2a9',
+    sender: '0x317d875ca3b9f8d14f960486c0d1d1913be74e90',
+    nonce: 2865,
+    afterBlock: 14088130,
+    token: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+    amount: 0.0001
+  }
+})
+
+A recovered payment still results in a confirmed or failed payment, and also calls one of those callbacks also when created with recover.
+
+```
+
 ## DePay Sales
 
 DePay Sales allows you to sell tokens directly from your website or dApp with automatic any-to-any payment conversion (so people can use any token when buying your token directly off your website or dApp).