Skip to content

Documentation availability

Paycux is in private beta. Most pages describe roadmap or reference material. The implemented boundary is published at docs/API_CONTRACTS.md in the release source and under What exists today in this documentation.

API Reference

Sign-in UI

Sign-in UI in the Paycux API: the endpoints, the fields they accept and return, and a working request in three languages.

Overview

The Sign-in UI resource is part of the Paycux API. Every field below is returned on every representation of the object, so you can rely on its shape across list, read and write calls.

FieldTypeNotes
idstringStable identifier, prefixed per resource type.
objectstringThe resource name, useful when handling webhook payloads.
created_attimestampISO 8601, always UTC.
updated_attimestampISO 8601, always UTC.

Endpoints

Every endpoint is authenticated with a bearer token and scoped to the environment the key belongs to.

MethodPathWhat it does
POST/user_management/cors_originsCreate a CORS origin
POST/user_management/users/:user_id/connected_accounts/:slugImport a connected account
POST/user_management/radar_challengesSend a Abuse Checks SMS challenge
GET/user_management/radar_challenges/:idGet Abuse Checks Challenge details

Create a CORS origin

POST /user_management/cors_origins — create a CORS origin.

1import Paycux from '@paycux/node';
2
3const paycux = new Paycux(process.env.PAYCUX_API_KEY);
4
5const result = await paycux.create_a_cors_origin();
6console.log(result);

Import a connected account

POST /user_management/users/:user_id/connected_accounts/:slug — import a connected account.

1import Paycux from '@paycux/node';
2
3const paycux = new Paycux(process.env.PAYCUX_API_KEY);
4
5const result = await paycux.import_a_connected_account();
6console.log(result);

Send a Abuse Checks SMS challenge

POST /user_management/radar_challenges — send a Abuse Checks SMS challenge.

1import Paycux from '@paycux/node';
2
3const paycux = new Paycux(process.env.PAYCUX_API_KEY);
4
5const result = await paycux.send_a_radar_sms_challenge();
6console.log(result);

Get Abuse Checks Challenge details

GET /user_management/radar_challenges/:id — get Abuse Checks Challenge details.

1import Paycux from '@paycux/node';
2
3const paycux = new Paycux(process.env.PAYCUX_API_KEY);
4
5const result = await paycux.get_radar_challenge_details();
6console.log(result);

Errors

Errors return a JSON body with a machine-readable code, a human-readable message and, for validation failures, the offending field.

StatusCodeMeaning
400invalid_requestA required field is missing or malformed.
401unauthorizedThe API key is missing, revoked, or from another environment.
404not_foundNo record with that ID in this environment.
429rate_limit_exceededBack off and retry after the interval in Retry-After.