OpenSkillIndex← back to search
claude-code

Awesome-omni-skill blindpay

Use when integrating with BlindPay for stablecoin-to-fiat payouts, fiat-to-stablecoin payins, receiver KYC management, bank accounts, blockchain wallets, virtual accounts, or offramp wallets.

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/blindpay" ~/.claude/skills/diegosouzapw-awesome-omni-skill-blindpay && rm -rf "$T"
manifest: skills/data-ai/blindpay/SKILL.md
source content

BlindPay Integration

Overview

BlindPay is a global payment infrastructure that enables worldwide money transfers using both traditional fiat currencies and stablecoins.

Key Capabilities:

FeatureDescription
PayoutsConvert stablecoins (USDC, USDT) to fiat and send to bank accounts
PayinsConvert fiat to stablecoins and send to blockchain wallets
Multi-ChainSupports Ethereum, Base, Polygon, Arbitrum, Stellar, Solana, Tron
Multi-CurrencyUSD, BRL, MXN, ARS, COP and more via ACH, Wire, PIX, SPEI, SWIFT
Virtual AccountsGenerate dedicated US bank accounts for receivers
Offramp WalletsAuto-convert incoming stablecoins to fiat

Important: BlindPay is non-custodial. Funds remain under user control throughout the process. Failed transactions are automatically returned to the originating wallet.

Quick Start

Authentication

All API calls require:

  • API Key: Passed as 
    Authorization: Bearer YOUR_API_KEY
  • Instance ID: Included in the URL path
curl --request GET \
  --url https://api.blindpay.com/v1/instances/in_000000000000/receivers \
  --header 'Authorization: Bearer YOUR_API_KEY'

Payout Flow (Stablecoin → Fiat)

  1. Accept Terms of Service → Get 
    tos_id
  2. Create Receiver → KYC verification, get 
    receiver_id
  3. Add Bank Account → Get 
    bank_account_id
  4. Create Payout Quote → Get 
    quote_id
    (valid for 5 minutes)
  5. Approve Tokens → ERC20 approval for BlindPay contract
  6. Execute Payout → Stablecoins collected, fiat sent to bank

See references/getting-started/stable-to-fiat.md for complete guide.

Payin Flow (Fiat → Stablecoin)

  1. Accept Terms of Service → Get 
    tos_id
  2. Create Receiver → KYC verification, get 
    receiver_id
  3. Add Blockchain Wallet → Get 
    blockchain_wallet_id
  4. Create Payin Quote → Get 
    payin_quote_id
    (valid for 5 minutes)
  5. Execute Payin → Get payment instructions (PIX code, CLABE, etc.)
  6. Send Fiat → Once received, stablecoins sent to wallet

See references/getting-started/fiat-to-stable.md for complete guide.

Payment Rails

TypeCountrySpeed
ACHUS~2 business days
WireUS~1 business day
RTPUSInstant
PIXBrazilInstant
SPEIMexicoInstant
ACH COPColombia~1 business day
Transfers 3.0ArgentinaInstant
International SWIFTGlobal~5 business days

Supported Networks

NetworkInstance TypeTokens
EthereumProductionUSDC, USDT
BaseProductionUSDC, USDT
PolygonProductionUSDC, USDT
ArbitrumProductionUSDC, USDT
StellarProductionUSDC
SolanaProductionUSDC, USDT
Tron (beta)ProductionUSDT
Sepolia, Base Sepolia, etc.DevelopmentUSDB (test token)

Development vs Production

FeatureDevelopmentProduction
KYCAuto-approvedManual/automatic review
PayoutsSimulated (no real fiat)Real bank transfers
PayinsAuto-completed after 30sReal fiat deposits required
TokenUSDB (fake stablecoin)USDC, USDT

Testing Scenarios

AmountResult
Any amountSuccess (default)
$666.00Failed
$777.00Refunded

Use first name "Fail" when creating receivers to simulate KYC rejection.

Error Handling

Always check API responses for errors:

{
  "error": {
    "message": "please_accept_terms_of_service",
    "code": "TERMS_NOT_ACCEPTED"
  }
}

Common errors:

  • please_accept_terms_of_service
    - Receiver needs to accept updated TOS
  • quote_expired
    - Quote older than 5 minutes, create a new one
  • insufficient_balance
    - Wallet doesn't have enough tokens
  • kyc_not_approved
    - Receiver KYC still pending or rejected

Reference Documentation

Getting Started

Essentials

Guides