PayAHuman

使用 Talentir 支付平台，通过电子邮件地址或社交媒体账号向创作者发放付款。

设置

1. 在 https://www.talentir.com/start/business 创建企业账户
2. 从 Talentir 控制台获取您的 API 密钥
3. 设置环境变量：

   export TALENTIR_API_KEY="your-api-key"
   

API 基础

所有请求均需包含以下参数：

curl -s "https://www.talentir.com/api/v1/..." 
  -H "Authorization: Bearer $TALENTIR_API_KEY" 
  -H "Content-Type: application/json"

付款（Payouts）

通过电子邮件创建付款

curl -s -X POST "https://www.talentir.com/api/v1/payout" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "description": "Payment for services",
    "email": "creator@example.com",
    "payoutAmount": "100.00",
    "currency": "EUR",
    "handleType": "none"
  }' | jq

通过社交媒体账号创建付款

支持的平台：tiktok、instagram、youtube-channel。

curl -s -X POST "https://www.talentir.com/api/v1/payout" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "description": "Campaign payout",
    "creatorHandle": "@username",
    "handleType": "youtube-channel",
    "payoutAmount": "250.00",
    "currency": "USD"
  }' | jq

带标签和自定义 ID 的付款

curl -s -X POST "https://www.talentir.com/api/v1/payout" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "description": "Q1 royalty payment",
    "email": "creator@example.com",
    "payoutAmount": "500.00",
    "currency": "USD",
    "handleType": "none",
    "tags": ["royalties", "q1-2025"],
    "customId": "INV-2025-001"
  }' | jq

根据 ID 查询付款

curl -s "https://www.talentir.com/api/v1/payout/{id}" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" | jq

根据自定义 ID 查询付款

curl -s "https://www.talentir.com/api/v1/payout/{customId}?id_type=custom_id" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" | jq

列出付款记录

curl -s "https://www.talentir.com/api/v1/payouts?limit=20&order_direction=desc" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" | jq

团队（Team）

获取团队信息

curl -s "https://www.talentir.com/api/v1/team" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" | jq

Webhook

列出 Webhook

curl -s "https://www.talentir.com/api/v1/webhook" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" | jq

创建 Webhook

curl -s -X POST "https://www.talentir.com/api/v1/webhook" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "targetUrl": "https://your-server.com/webhook",
    "eventType": "payout",
    "environment": "production"
  }' | jq

请安全保存返回的 signingSecret —— 该值仅显示一次，后续不可再次查看。

删除 Webhook

curl -s -X DELETE "https://www.talentir.com/api/v1/webhook/{id}" 
  -H "Authorization: Bearer $TALENTIR_API_KEY" | jq

付款字段参考（Payout Fields Reference）

付款状态（Payout Statuses）

created → approved → requested → completed

付款在任意时刻也可能变为 deleted 或 expired 状态。

注意事项（Notes）

• 金额必须为字符串格式（例如 "100.00"，而非 100）
• 最低付款金额为 "0.1"
• Webhook 签名采用 HMAC-SHA256 算法，签名依据请求头 X-Talentir-Signature 和 X-Talentir-Timestamp