UPSIDERDevelopers

Getting Started

API Documentation

UPSIDER APIを使って、与信判定・決済・データ分析を統合できます。 このガイドでは、最初のAPI呼び出しまでの手順を説明します。

Base URL

https://api.upsider.co.jp

Sandbox: https://sandbox.api.upsider.co.jp

1APIキーの取得

ダッシュボードからAPIキーを取得します。テスト用には sk_test_ プレフィックスのキーを使用してください。

# テスト用APIキー

sk_test_xxxxxxxxxxxxxxxxxxxx

# 本番用APIキー

sk_live_xxxxxxxxxxxxxxxxxxxx

2サンドボックス環境でのテスト

サンドボックス環境では、実際の取引なしにAPIの動作を確認できます。 テストデータは自動的にリセットされます。全てのAPIエンドポイントがサンドボックスで利用可能です。

3最初のAPI呼び出し

以下のコードで与信評価APIを呼び出してみましょう。

curl https://api.upsider.co.jp/v1/credit/evaluate \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "comp_abc123",
    "requested_amount": 5000000,
    "currency": "JPY"
  }'

Response

200 OK
{
  "id": "cdec_9f8e7d6c5b4a",
  "object": "credit_decision",
  "status": "approved",
  "company_id": "comp_abc123",
  "requested_amount": 5000000,
  "approved_amount": 5000000,
  "currency": "JPY",
  "risk_score": 0.12,
  "factors": [
    { "name": "revenue_growth", "impact": "positive" },
    { "name": "payment_history", "impact": "positive" },
    { "name": "industry_risk", "impact": "neutral" }
  ],
  "expires_at": "2026-04-28T00:00:00Z",
  "created_at": "2026-03-29T10:30:00Z"
}

Authentication

全てのAPIリクエストには認証が必要です。Authorization ヘッダーにBearer トークンとしてAPIキーを含めてください。

Authorization: Bearer sk_test_xxxxxxxxxxxx

Credit API

AI与信エンジンを利用したリアルタイム与信判定API。

POST/v1/credit/evaluate

企業の与信評価をリクエストします。AIモデルがリアルタイムデータを基に判定。

GET/v1/credit/decisions/{id}

与信判定結果を取得します。判定IDを指定してください。

Payment API

カード発行・決済処理・トランザクション管理。

POST/v1/cards

新しいバーチャルカードまたは物理カードを発行します。

GET/v1/transactions

トランザクション一覧を取得します。フィルタ・ページネーション対応。

POST/v1/payments

支払いを作成します。振込先・金額・スケジュールを指定。

Data API

決済データの分析レポートを取得。

GET/v1/reports

レポート一覧を取得します。月次・カスタム期間で生成可能。

GET/v1/analytics

リアルタイム分析データ。支出カテゴリ・トレンド・予測。

Webhooks

イベント発生時にHTTPコールバックでリアルタイム通知を受信。

Event Types

credit.decision.completed与信判定が完了
card.created新しいカードが発行された
transaction.authorized取引が承認された
transaction.declined取引が拒否された
payment.completed支払いが完了
report.readyレポートの生成が完了

Signature Verification

Webhookの署名を検証して、リクエストがUPSIDERから送信されたことを確認します。

Upsider-Signature: t=1711700000,v1=5a2f...

MCP Server

AIエージェントからUPSIDER APIを利用するためのMCPサーバー。

MCP Integration Guide

This is a sample developer portal for demonstration purposes. All API endpoints, keys, and data shown are fictional.