Skip to main content
POST
/
v1
/
sessions
Create session
curl --request POST \
  --url https://api.daimo.com/v1/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": {
    "type": "evm",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "chainId": 8453,
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amountUnits": "10.00"
  },
  "display": {
    "title": "Deposit to Acme",
    "verb": "Deposit"
  }
}
'
{
  "session": {
    "sessionId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "status": "requires_payment_method",
    "destination": {
      "type": "evm",
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "chainId": 8453,
      "chainName": "Base",
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "tokenSymbol": "USDC",
      "amountUnits": "10.00"
    },
    "display": {
      "title": "Deposit to Acme",
      "verb": "Deposit"
    },
    "paymentMethod": null,
    "metadata": null,
    "clientSecret": "d7a8f3b2e1c94a6db8f0e2a7c3d5b9f1",
    "createdAt": 1700000000,
    "expiresAt": 1700003600
  }
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token

Body

application/json
​
destination
object
required
​
display
object
required
​
metadata
object

Key-value string pairs for your own use. For fiat sessions, set email to start at email OTP, or phone as an E.164 phone hint for Apple Pay.

Example:
{
  "email": "account@daimo.com",
  "phone": "+14155552671",
  "orderId": "123"
}
​
refundAddress
string

Address to receive funds if a contract call reverts

Pattern: ^0x[0-9a-fA-F]{40}$

Response

Session created

​
session
object
required