Get the current BILL exchange rate and exchange rate batch ID for paying an international vendor. When the vendor bill currency is not USD, the exchange rate batch ID is required for creating a payment with POST /v3/payments or POST /v3/payments/bulk.
BILL maintains all exchangeRate values in a batch. When a batch expires, a new batch ID is generated and all exchangeRate values are updated in the new batch. Use this endpoint to get the current exchange rate and batch ID based on the payment amount and vendor bill currency.
In production, the batch expiration time is 20 minutes. The expirationTime in the response tells us when the current batch will expire. When the batch expires, you need a new batch ID for your payments API operations. The batch expiration date is tied to the processDate you can set in your international payments API request (with POST /v3/payments or POST /v3/payments/bulk).
Note:
- International vendor payment information is required for you to get the BILL exchange rate with this endpoint.
- When the vendor bill currency is not
USD, the paymentprocessDatemust be the next US business day.
