Deposit Flow

With deposit flow, you can let your users deposit money into their accounts, keep track of user balances, and charge them for your services later.

Note that repaya is not at any time in control or has any possession of your or your customer's funds. You are fully responsible and in control of your users' funds handling and custody.

The algorithm of user deposits generally consists of two steps

1. Payment processing

At this step, you set up a payment request integration with repaya to let your customer make a payment to their balance.

2. Getting user balance

After you have successfully received payment, you can request user balances from repaya. From now on, repaya is only tracking the number of funds deposited, so you will need to set up some further billing processes to deduct from the user balance when the user performs a purchase or pays for a service in your app.

Payment Form

Set up a Payment Request form and fill in the necessary details:

• Title (for example, "Deposit to App")

• Coins that you accept for payment

• Your receiving blockchain address

• Your return URL. This is the address on your website to redirect customers after they complete the payment.

Backend Integration

To build the deposit flow on your site, you will need to make three things happen from your server:

1. Create a payment session and redirect users by the URL you get from repaya API

2. Check payment status

3. Request user balance and display it to the user

1. Create a payment session

Perform a request to repaya's Rest API to create a payment session. Set the id of the customer field to the corresponding user ID in your own database to be able to match them after the payment is complete. Use the checkoutUrl field from the response to redirect your user.

Create payment session

Create a payment session to initiate the checkout flow

post

/session

Authorizations

Body

formLinkIdstringrequired

Example: jAY7k

clientIdstring

Example: key_1432

priceobject

Example: {"USD_MULTI_1":"15.0"}

customerobject

productobject

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://repaya.io/api/public/1/session' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "formLinkId": "jAY7k",
    "clientId": "key_1432",
    "price": {
      "USD_MULTI_1": "15.0"
    },
    "customer": {
      "id": "user_123141",
      "data": "text"
    },
    "product": {
      "id": "product_123141",
      "name": "Awesome product",
      "data": "text"
    }
  }'

200

200

{
  "checkoutUrl": "https://repaya.io/checkout/id_124124",
  "id": "id_124124",
  "formLinkId": "jAY7k",
  "receiver": "0x0000000000000000000000000000000000000000",
  "clientId": "key_1432",
  "price": {
    "USD_MULTI_1": "15.0"
  },
  "customer": {
    "id": "user_123141"
  },
  "product": {
    "id": "product_123141",
    "name": "Awesome product"
  }
}

Payment session created

2. Verify payment

When the payment is completed, the customer will be redirected to your website on the return URL you provided during the payment form setup. Verify the payment status at this step by requesting it via the API. The sessionId for the request will be provided to you in the query parameter of the return URL.

Save the resulting payment in your DB if you want to enumerate all the customer payments later or use them another way.

Get customer's payment in the given session

get

/payment

Authorizations

Query parameters

sessionIdstringrequired

Payment session ID

Example: id_124124

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://repaya.io/api/public/1/payment?sessionId=id_124124' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

{
  "id": "pid_3251",
  "sender": "0x0000000000000000000000000000000000000000",
  "receiver": "0x0000000000000000000000000000000000000000",
  "amount": "15.0",
  "paidAmount": "5.0",
  "status": "pending",
  "customer": {
    "id": "user_123141",
    "data": "text"
  },
  "product": {
    "id": "product_123141",
    "name": "Awesome product",
    "data": "text"
  },
  "coin": {
    "code": "USD_MULTI_1",
    "name": "USD Stablecoins"
  }
}

A payment associated with a given session, null if missing

3. Request user balances

After the payment, you can finally request the user balance from repaya.

Get customer balances

get

/balance

Authorizations

Query parameters

formLinkIdstringrequired

Payment form ID

Example: jAY7k

customerIdstring

Filter by customer, pass an empty string to get the total balance

Example: user_123141

productIdstring

Filter by product, pass an empty string to get the total balance

Example: product_123141

coinstring

Filter by coin

Example: USD_MULTI_1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://repaya.io/api/public/1/balance?formLinkId=jAY7k' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

[
  {
    "customerId": "user_123141",
    "productId": "product_123141",
    "balance": "123.08",
    "coin": {
      "code": "USD_MULTI_1",
      "name": "USD Stablecoins"
    }
  }
]

List of customer balances

To let your users purchase products in your app or pay for services, you need to establish some billing process and keep track of the number of funds you deducted from user balances. Then the final user balance will be the sum of balances from repaya and the ones from your backend or database.

See also

Check out the full Rest API Reference and Client libraries section to find out more.

You can also find the complete working example for this flow on Github.