Documentation for API V2. Major update is addresses with exchange crypto to fiat and vice versa abilities.

General Information

In the production environment, the API endpoint for all requests is:

1. https://app.shopperoo.com/api/v2


In the test environment, the API endpoint for all requests is:

1. https://app.sandbox.shopperoo.com/api/v2

Deposit Process

  1. You get a new address from the Shopperoo API (for some currencies, it'll be address and tag) and save it somewhere on your computer. After then, you show your customer this address in order for them to make a deposit.
  2. This is the address to which the customer transfers money.
  3. When a consumer sends a transaction, Shopperoo sends a callback with the transaction data to your callback url. It includes information such as the status, address, currency, amount, and fees.
    If the status is successful, you should deposit the appropriate amount into the customer's account.

Withdrawal Process

  1. You ask for a certain quantity of money to be sent to a specific address.
  2. On our end, your request is verified. If your signature is correct, your address is legitimate, and you have sufficient funds, Shopperoo will send you the transaction object.
  3. When the transaction status is updated, you will be contacted via a callback.
Please note that the final status and all computations on your end will be implemented only after getting a final callback from Shopperoo; therefore, if you do not see a transaction on your end due to a connection disruption, please wait for a final callback or check a transaction in the back-office.

Withdrawal with exchange process

You want to send crypto from your fiat cash account. For example, you wish to send a sum in EUR, but your customer only accepts BTC.

  1. You follow the identical steps as when making a withdrawal, but you specify two currencies. One is the currency in which your sending balance is held, and the other is the cryptocurrency that your customer wishes to receive.
  2. On our end, your request is verified. If your signature is correct, your address is legitimate, and you have sufficient funds, Shopperoo will send you the transaction object.
  3. You receive a callback when transaction status is updated.

Futures Process

In order to guarantee a receiving amount, the rates should be fixed.

  1. You submit your exchange address. (If receiving currency rates isn't necessary, you can skip this step.)
  2. You get rates and the fixed time
  3. You must supply the exchange pair and the amount owing to confirm futures.
  4. Shopperoo transforms all arriving funds to destination funds and delivers notifications as if it were a regular deposit when a new deposit arrives.

If the funds submitted and received are not identical, Shopperoo turns it to a conventional deposit with exchange.

Invoice Process

Invoices enable you to make deposits at a fixed rate for a set period of time, regardless of exchange rate movements. This option will allow you to view the precise amount of a sender's currency required to receive the exact amount in a receiver's currency if you need to convert funds to fiat currency or another crypto currency. When a deposit is processed through this flow, the user is sent to the appropriate Invoice page via the preconfigured link, where they must simply follow the instructions. It also provides for reimbursements in the event that a user fails to deposit within the specified deadline or discovers a non-sufficient amount. In that instance, all that is required is for the consumer to click on the link and follow the instructions that were delivered to his or her e-mail.