Online Store

Last updated 1 year ago

Was this helpful?

Online Store

Online store integration enables you to sell multiple products at their corresponding prices using a single payment form. You can also track how much each customer paid for products or the total amount paid for all products in your store.

Payment Form

Your store address (for example, mystore.com)
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. More information on it is below.

Backend Integration

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

Create a payment session and redirect users by the URL you get from repaya API
Handle returning users after they complete the payment

1. Create a payment session

To let your customers select the quantity of the product, just include it in the form on your site and then fill in the session request as follows:

{
  // ...
  product: {
    name: "Awesome product x5",
    id: "product_12345"
    data: "{ \"quantity\": \"5\" }"
  }
  // ...
}

When a customer completes the payment, you will get back this payment data for further verification on your side.

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.

Keep your payment session ID a secret. During the checkout flow, it should only be revealed to the customer who is performing the payment at the moment. It is also used to register and identify the payment.

Payment Form

Set up an form and fill in the necessary details:

Your store address (for example, mystore.com)
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. More information on it is below.

Backend Integration

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

Create a payment session and redirect users by the URL you get from repaya API
Handle returning users after they complete the payment

1. Create a payment session

Perform a request to repaya's to create a payment session. Be sure to set IDs in the customer and product fields to the corresponding IDs in your own database to be able to verify them after the payment is complete. Use the checkoutUrl field from the response to redirect your user.

To let your customers select the quantity of the product, just include it in the form on your site and then fill in the session request as follows:

{
  // ...
  product: {
    name: "Awesome product x5",
    id: "product_12345"
    data: "{ \"quantity\": \"5\" }"
  }
  // ...
}

When a customer completes the payment, you will get back this payment data for further verification on your side.

2. Verify payment

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

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

Create payment session

post

Create a payment session to initiate the checkout flow

Authorizations

Body

formLinkIdstringRequiredExample: jAY7k

customerobjectOptional

productobjectOptional

priceobjectOptionalExample: {"USD_MULTI_1":"15.0"}

clientIdstringOptionalExample: key_1432

Responses

application/json

objectOptional

post

POST /api/public/1/session HTTP/1.1
Host: repaya.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 194

{
  "formLinkId": "jAY7k",
  "customer": {
    "id": "user_123141",
    "data": "text"
  },
  "product": {
    "id": "product_123141",
    "name": "Awesome product",
    "data": "text"
  },
  "price": {
    "USD_MULTI_1": "15.0"
  },
  "clientId": "key_1432"
}

200

Payment session created

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

Online Store

Online Store

Payment Form

Backend Integration

1. Create a payment session

2. Verify payment

See also

Payment Form

Backend Integration

1. Create a payment session

2. Verify payment

See also

Get customer's payment in the given session

Create payment session