Skip to main content
Rise B2B API supports secure, on-chain payments for payroll and business operations. All payments are processed through blockchain transactions with EIP-712 typed data signing for enhanced security.

Payment Types

Rise B2B supports two main payment types:

Individual Payments

Single payments to one recipient

Batch Payments

Multiple payments to multiple recipients in one transaction

Payment Flow

The Rise payment process follows a secure 3-step flow:
1

Create Payment

Create payment and get typed data using POST /v2/payments
2

Sign with Wallet

Sign the typed data using your Web3 wallet
3

Execute Payment

Submit the signed data using PUT /v2/payments to execute on-chain

Payment Security

On-Chain Verification

All payments are verified and executed on the blockchain

Typed Data Signing

EIP-712 signatures prevent tampering and replay attacks

HTTPS Required

All API communications use encrypted HTTPS

Contract Validation

Verify contract addresses and chain IDs

API Endpoints

1. Create Payment

POST ${this.baseUrl}/v2/payments Creates a payment and returns EIP-712 typed data for signing.

2. Execute Payment

PUT ${this.baseUrl}/v2/payments Executes the payment using signed typed data.

3. Query Payments

GET ${this.baseUrl}/v2/payments Query payments for a team with optional filtering.

API Integration Example

Payment Data Structure

Payment Request

Query Parameters

Payment Timing

Rise supports two payment timing options:

Payment States

Payments go through several states during processing:

Error Handling

Common payment errors and solutions:

Best Practices

Always review payment details before signing to prevent unauthorized transactions.
  • Verify Recipients: Double-check recipient addresses and amounts
  • Monitor Balances: Ensure sufficient funds before creating payments
  • Track Status: Monitor payment status through the query endpoint
  • Handle Errors: Implement proper error handling for failed payments
  • Security: Use HTTPS and verify contract addresses
  • Rate Limiting: Implement appropriate rate limiting for payment queries
  • Wallet Security: Keep private keys secure and never expose them in client-side code

Payment Integration Guide

Complete payment integration examples

Web3 Integration

Wallet integration and signing

Entity Balance

Managing entity balances

Teams

Team payment permissions
Payment Precision: All payment amounts are specified in cents to maintain precision. Convert to decimal format only when displaying to users.