TrieOH
PayssageAPIOauth

Start a payment-provider OAuth connection

Starts an OAuth connection to the given payment provider (`mercadopago`). Callers must pass the flow (`collector` or `seller`) and the final redirect URL (where the user lands after the provider's consent screen). The provider redirect URI is Payssage's own callback (`/providers/{provider}/callback`), configured on the server (`MP_REDIRECT_URI`) — callers never supply one. The response carries the URL to send the user to.

POST/providers/{provider}/connect

Starts an OAuth connection to the given payment provider (mercadopago). Callers must pass the flow (collector or seller) and the final redirect URL (where the user lands after the provider's consent screen). The provider redirect URI is Payssage's own callback (/providers/{provider}/callback), configured on the server (MP_REDIRECT_URI) — callers never supply one. The response carries the URL to send the user to.

Authorization

AuthorizationBearer <token>

JWT issued by IdentityX, signed with Ed25519

In: header

Path Parameters

provider*string

Payment provider slug (e.g. mercadopago).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for starting a provider OAuth connection. Mirrors models.ConnectRequest.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/providers/string/connect" \  -H "Content-Type: application/json" \  -d '{    "flow": "collector",    "final_redirect_url": "https://app.trieoh.com/settings/payments",    "wallet_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"  }'
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 0,
    "has_next": true,
    "has_prev": true,
    "next_page": 0,
    "prev_page": 0
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string",
  "data": "http://example.com"
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}
{
  "code": 0,
  "message": "string",
  "error": {
    "code": "BAD_REQUEST",
    "message": "string",
    "fields": [
      {
        "field": "string",
        "message": "string"
      }
    ],
    "meta": {},
    "debug": {
      "raw_error": "string",
      "stack_trace": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "module": "string"
}

Create an intent directly (test mode) POST

Test-mode helper: hard-creates an intent with full control over its status, provider, and provider data — no payment provider is contacted. Use to simulate provider outcomes (e.g. seed a `succeeded` intent so downstream systems observe the webhook flow). Must be a wallet owner.

Payment-provider OAuth callback GET

Browser redirect target: the provider lands here after the user authorizes. Payssage exchanges the code, stores the provider credential, and redirects the browser to the `final_redirect_url` captured at connect time. Public — the provider's OAuth flow cannot send an Authorization header.