API Reference | repaya.io Documentation

repaya.io Documentation

Clients

Typescript / Javascript

yarn add @repaya/client

Example project on

Quick Start

import { Client } from '@repaya/client';
import express from 'express';

const apiToken = process.env.REPAYA_API_TOKEN;  /* repaya API token */
const formId = process.env.REPAYA_FORM_ID;      /* repaya payment form id */

/* create repaya client for the ethereum mainnet */
const repaya = new Client(process.env.REPAYA_DOMAIN, apiToken);  

const app = express();

app.use(express.static('public'));

/* Initiate the checkout fow and redirect user to complete the payment */
app.post('/checkout', async (req, res) => {
    const userId = 'user_42';           /* replace with the one in your system */
    const productId = 'product_65291';  /* replace with the one in your system */

    /* create a payment session */
    const session = await repaya.sessions.create(formId, {
    	customer: { id: userId },
     	product: {
            id: productId,
            name: 'Awesome product'
      	},
      	price: {
            USD_MULTI_1: '5.0',
     	}
    });
  
    res.redirect(303, session.checkoutUrl);
});

/* Handle the customer after the checkout and validate payment status */
app.get('/after_checkout', async (req, res) => {
    const sessionId = req.query.session;

    const payment = await repaya.payments.getBySession(sessionId);
	
    if (!payment || payment.status !== 'completed') {
        res.redirect(303, '/error');
        return;
    }

    res.redirect(303, '/success');
})

const port = process.env.PORT
app.listen(port, () => console.log(`Running server on port ${port}`));

Endpoints

Address

Description

https://repaya.io/api/public/1

Ethereum Mainnet

https://goerli.repaya.io/api/public/1

Goerli Ethereum Testnet

Authorization

Authorization is done via HTTP Authentication.

Provide your API Token within the corresponding header to get access to all API methods:

Authorization: Bearer <API_TOKEN>

Method

OpenAPI Spec

Get customer's payment in the given session

get

Authorizations

Query parameters

sessionIdstringrequired

Payment session ID

Example: id_124124

Responses

application/json

object | nullableoptional

get

GET /api/public/1/payment HTTP/1.1
Host: repaya.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

A payment associated with a given session, null if missing

{
  "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"
  }
}

List payments

get

Authorizations

Query parameters

formIdstringrequired

Payment form ID

Example: jAY7k

limitnumberrequired

Limit the number of results

Example: 100

pagenumberrequired

Page number

Example: 3

sortstring · enumrequired

Sort direction (by "created")

Example: ascAvailable options:

fromTimestampnumberrequired

From timestamp in milliseconds

Example: 1669839216188

tillTimestampnumberrequired

Till timestamp in milliseconds

Example: 1669839216188

Responses

application/json

object[]optional

get

GET /api/public/1/payment/list HTTP/1.1
Host: repaya.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of payments filtered by the given parameters.

[
  {
    "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"
    }
  }
]

Get customer balances

get

Authorizations

Query parameters

formLinkIdstringrequired

Payment form ID

Example: jAY7k

customerIdstringoptional

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

Example: user_123141

productIdstringoptional

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

Example: product_123141

coinstringoptional

Filter by coin

Example: USD_MULTI_1

Responses

application/json

object[]optional

get

GET /api/public/1/balance HTTP/1.1
Host: repaya.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of customer balances

[
  {
    "customerId": "user_123141",
    "productId": "product_123141",
    "balance": "123.08",
    "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"
}