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/problem+json

application/problem+json

application/problem+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"  }'
"http://example.com"
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 400,
  "title": "Validation Failed"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 401,
  "title": "Unauthenticated"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 500,
  "title": "Internal Server Error"
}

Refund an intent directly (test mode) POST

Test-mode helper: flips a `succeeded` intent to `refunded` and stamps a fake refund marker in provider_data — no payment provider is contacted. Use to simulate the provider's `payment.refunded` outcome for downstream testing without a real refund.

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.