Skip to main content
POST
/
transactions
/
record-send
curl -X POST "https://api.chipipay.com/v1/transactions/record-send" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "x-api-key: pk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionHash": "0x1234567890abcdef...",
    "expectedSender": "0x049d365...",
    "expectedRecipient": "0x0abcdef...",
    "expectedToken": "USDC",
    "expectedAmount": "10.5",
    "chain": "STARKNET"
  }'

{
  "id": "tx_abc123",
  "type": "SEND",
  "chain": "STARKNET",
  "transactionHash": "0x1234567890abcdef...",
  "senderAddress": "0x049d365...",
  "destinationAddress": "0x0abcdef...",
  "token": "USDC",
  "tokenAddress": "0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb",
  "amount": "10500000",
  "status": "PENDING",
  "createdAt": "2025-03-15T10:30:00Z",
  "updatedAt": "2025-03-15T10:30:00Z",
  "apiPublicKey": "pk_xxxx"
}

curl -X POST "https://api.chipipay.com/v1/transactions/record-send" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "x-api-key: pk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionHash": "0x1234567890abcdef...",
    "expectedSender": "0x049d365...",
    "expectedRecipient": "0x0abcdef...",
    "expectedToken": "USDC",
    "expectedAmount": "10.5",
    "chain": "STARKNET"
  }'

{
  "id": "tx_abc123",
  "type": "SEND",
  "chain": "STARKNET",
  "transactionHash": "0x1234567890abcdef...",
  "senderAddress": "0x049d365...",
  "destinationAddress": "0x0abcdef...",
  "token": "USDC",
  "tokenAddress": "0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb",
  "amount": "10500000",
  "status": "PENDING",
  "createdAt": "2025-03-15T10:30:00Z",
  "updatedAt": "2025-03-15T10:30:00Z",
  "apiPublicKey": "pk_xxxx"
}

​
Notes

  • The expectedAmount is in human-readable format (e.g., "10.5" for 10.5 USDC). The API converts it to raw format internally.
  • The transaction is verified on-chain. If the hash doesn’t match the expected sender/recipient/amount, the request will fail.

Authorizations

​
Authorization
string
header
required

Bearer token — use your secret key (sk_prod_xxx) for server-side calls, or the user's JWT for client-side calls

​
x-api-key
string
header
required

Your Chipi public API key (pk_xxx)

Body

application/json
​
transactionHash
string
required

The on-chain transaction hash

​
expectedSender
string
required

The sender's wallet address

​
expectedRecipient
string
required

The recipient's wallet address

​
expectedToken
enum<string>
required

Token identifier

Available options:
USDC,
USDC_E,
USDT,
DAI,
ETH,
STRK,
SLINK,
ALF,
BROTHER,
ARB,
DOC,
MXNB,
WLD,
WBTC,
OTHER
​
expectedAmount
string
required

The expected transfer amount (human-readable, e.g., "10.5")

​
chain
enum<string>
required

Blockchain network identifier

Available options:
STARKNET,
BASE,
ARBITRUM,
OPTIMISM,
ROOTSTOCK,
SCROLL,
WORLDCHAIN

Response

Transaction recorded

​
id
string
required

Unique transaction identifier

​
chain
enum<string>
required

Blockchain network identifier

Available options:
STARKNET,
BASE,
ARBITRUM,
OPTIMISM,
ROOTSTOCK,
SCROLL,
WORLDCHAIN
​
transactionHash
string
required

On-chain transaction hash

​
senderAddress
string
required

The sender's wallet address

​
destinationAddress
string
required

The recipient's wallet address

​
status
enum<string>
required

Transaction lifecycle status

Available options:
PENDING,
PROCESSING,
SUCCESS,
FAILED,
CANCELLED
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
apiPublicKey
string
required

The API key that created this transaction

​
type
string

Transaction type

​
subType
string

Transaction sub-type

​
contractAddress
string

The contract that was called

​
contractName
string
​
functionName
string

The contract function that was called

​
functionSelector
string
​
token
enum<string>

Token identifier

Available options:
USDC,
USDC_E,
USDT,
DAI,
ETH,
STRK,
SLINK,
ALF,
BROTHER,
ARB,
DOC,
MXNB,
WLD,
WBTC,
OTHER
​
tokenAddress
string

The token's contract address

​
amount
string

Transfer amount (raw, divide by 10^decimals)

​
skuId
string

SKU ID if this is a service purchase

​
skuReference
string

Reference provided for the SKU purchase

​
skuPurchaseAmount
number

Purchase amount in local currency

​
skuPurchaseCurrency
enum<string>

Fiat currency code

Available options:
MXN,
USD
​
skuFileNumber
string

File number from the service provider

​
confirmedAt
string<date-time>
​
chipiWalletId
string

Internal wallet ID of the sender

​
destinationChipiWalletId
string

Internal wallet ID of the recipient (if also a Chipi wallet)