Raims CLIAPI commands
raims payment-links
Manage payment links
Look up syntax, arguments, and options for each command. Use raims COMMAND --help to read the help in your terminal.
raims payment-links
Manage payment links
Shell
raims payment-links [flags]--help,-hbooldefault: false- help for payment-links
--colorstringdefault: auto- Terminal colors: auto, on or off (JSON and completion stay uncolored)
--debugbooldefault: false- Write diagnostic JSON events to stderr without credentials or command arguments
--environmentstringdefault: empty- Select sandbox or production for OAuth or an OAuth dry run; API keys determine their own environment
--mapstringdefault: empty- List the command tree without executing a command: tree, compact, paths or json
--no-inputbooldefault: false- Disable interactive prompts (also enforced in CI and without a terminal)
--output,-ostringdefault: text- Output format: text or json
--profilestringdefault: empty- Use a profile for this command (overrides RAIMS_PROFILE and the saved default)
Subcommands: raims payment-links create, raims payment-links get, raims payment-links list, raims payment-links send-email, raims payment-links update.
raims payment-links create
Create or retrieve a payment link
Shell
raims payment-links create [flags]--body-nullstringArraydefault: []- Set a nullable JSON body field to null by its JSON name (repeat for each field; cannot be combined with --data-file)
--cancel-redirect-urlstringdefault: empty- Set JSON body field cancel_redirect_url (string, nullable)
--charge-idstringdefault: empty- Set JSON body field charge_id (string, required in the body)
--data-filestringdefault: empty- Read the JSON request body from a UTF-8 file, or '-' for stdin
--dry-runbooldefault: false- Validate and preview the request without credentials or network access
--help,-hbooldefault: false- help for create
--idempotency-keystringdefault: empty- Reuse this optional idempotency key when retrying the same request
--payment-method-typesintegerArraydefault: empty- Set JSON body field payment_method_types (array<integer>, repeat the option for each item, nullable)
--show-headersbooldefault: false- Show public response headers without credentials or cookies
--success-redirect-urlstringdefault: empty- Set JSON body field success_redirect_url (string, nullable)
--timeoutdurationdefault: 1m0s- Total request timeout, including retries (for example 30s or 2m)
--colorstringdefault: auto- Terminal colors: auto, on or off (JSON and completion stay uncolored)
--debugbooldefault: false- Write diagnostic JSON events to stderr without credentials or command arguments
--environmentstringdefault: empty- Select sandbox or production for OAuth or an OAuth dry run; API keys determine their own environment
--mapstringdefault: empty- List the command tree without executing a command: tree, compact, paths or json
--no-inputbooldefault: false- Disable interactive prompts (also enforced in CI and without a terminal)
--output,-ostringdefault: text- Output format: text or json
--profilestringdefault: empty- Use a profile for this command (overrides RAIMS_PROFILE and the saved default)
Create or retrieve a payment link.
POST /v1/payment_links
Uses https://api.raims.com and the credential referenced by the selected profile. The API validates the credential's company, environment and permissions. API keys determine their own environment; --environment is available only with OAuth.
Use --dry-run to validate and preview the request without reading a profile, loading credentials or contacting the API. Add --environment to preview an OAuth request; without it, the preview uses API-key authentication and has no environment header.
OAuth environments accepted by this operation: Sandbox, Production.
Read the JSON request body with --data-file PATH, or --data-file - for standard input. You can also provide the body options listed below. Repeat array options for each item. Do not combine file input with body options. Only supplied fields are sent. When listed, --body-null FIELD sends an explicit null for a nullable field. Array size and uniqueness follow the endpoint contract. Objects without dedicated body options and arrays of objects use file input.
JSON body fields:
cancel_redirect_url string optional, nullable
charge_id string required
payment_method_types array<integer> optional, nullable; allowed: 1, 2
success_redirect_url string optional, nullable
Nested requirements apply when the parent object is present, or for each supplied array item. Omit an optional field to leave it unspecified; null is accepted only for nullable fields.
JSON body example (save as request.json):
{
"charge_id": "ch_4CnJiWSrsZBoaTg47OcMzD",
"success_redirect_url": "https://loja.example.com/pedido/concluido",
"cancel_redirect_url": "https://loja.example.com/pedido",
"payment_method_types": [
1
]
}
Example values are illustrative. Replace resource IDs and review the request before sending it.Command example
Shell
raims --profile PROFILE --output json payment-links create --data-file request.json --dry-run
raims payment-links create --charge-id="ch_4CnJiWSrsZBoaTg47OcMzD" --dry-runraims payment-links get
Get a payment link
Shell
raims payment-links get ID [flags]--dry-runbooldefault: false- Validate and preview the request without credentials or network access
--help,-hbooldefault: false- help for get
--show-headersbooldefault: false- Show public response headers without credentials or cookies
--timeoutdurationdefault: 1m0s- Total request timeout, including retries (for example 30s or 2m)
--colorstringdefault: auto- Terminal colors: auto, on or off (JSON and completion stay uncolored)
--debugbooldefault: false- Write diagnostic JSON events to stderr without credentials or command arguments
--environmentstringdefault: empty- Select sandbox or production for OAuth or an OAuth dry run; API keys determine their own environment
--mapstringdefault: empty- List the command tree without executing a command: tree, compact, paths or json
--no-inputbooldefault: false- Disable interactive prompts (also enforced in CI and without a terminal)
--output,-ostringdefault: text- Output format: text or json
--profilestringdefault: empty- Use a profile for this command (overrides RAIMS_PROFILE and the saved default)
Get a payment link.
GET /v1/payment_links/{id}
Uses https://api.raims.com and the credential referenced by the selected profile. The API validates the credential's company, environment and permissions. API keys determine their own environment; --environment is available only with OAuth.
Use --dry-run to validate and preview the request without reading a profile, loading credentials or contacting the API. Add --environment to preview an OAuth request; without it, the preview uses API-key authentication and has no environment header.
OAuth environments accepted by this operation: Sandbox, Production.Command example
Shell
raims --profile PROFILE --output json payment-links get ID --dry-runraims payment-links list
List payment links
Shell
raims payment-links list [flags]--afterstringdefault: empty- Read after this opaque cursor (cannot be combined with --before)
--allbooldefault: false- Read all pages as separate results (JSON Lines with --output json)
--beforestringdefault: empty- Read before this opaque cursor (cannot be combined with --after)
--charge-idstringdefault: empty- Filter by charge ID
--dry-runbooldefault: false- Validate and preview the request without credentials or network access
--help,-hbooldefault: false- help for list
--max-pagesintdefault: 100- Maximum pages to read with --all (1-10000)
--page-sizeint64default: 10- Results per page (the API normalizes the requested size)
--show-headersbooldefault: false- Show public response headers without credentials or cookies
--timeoutdurationdefault: 1m0s- Total request timeout, including retries (for example 30s or 2m)
--colorstringdefault: auto- Terminal colors: auto, on or off (JSON and completion stay uncolored)
--debugbooldefault: false- Write diagnostic JSON events to stderr without credentials or command arguments
--environmentstringdefault: empty- Select sandbox or production for OAuth or an OAuth dry run; API keys determine their own environment
--mapstringdefault: empty- List the command tree without executing a command: tree, compact, paths or json
--no-inputbooldefault: false- Disable interactive prompts (also enforced in CI and without a terminal)
--output,-ostringdefault: text- Output format: text or json
--profilestringdefault: empty- Use a profile for this command (overrides RAIMS_PROFILE and the saved default)
List payment links.
GET /v1/payment_links
Uses https://api.raims.com and the credential referenced by the selected profile. The API validates the credential's company, environment and permissions. API keys determine their own environment; --environment is available only with OAuth.
Use --dry-run to validate and preview the request without reading a profile, loading credentials or contacting the API. Add --environment to preview an OAuth request; without it, the preview uses API-key authentication and has no environment header.
OAuth environments accepted by this operation: Sandbox, Production.Command example
Shell
raims --profile PROFILE --output json payment-links list --dry-runraims payment-links send-email
Request delivery of a payment link by email
Shell
raims payment-links send-email ID [flags]--dry-runbooldefault: false- Validate and preview the request without credentials or network access
--help,-hbooldefault: false- help for send-email
--idempotency-keystringdefault: empty- Reuse this optional idempotency key when retrying the same request
--show-headersbooldefault: false- Show public response headers without credentials or cookies
--timeoutdurationdefault: 1m0s- Total request timeout, including retries (for example 30s or 2m)
--colorstringdefault: auto- Terminal colors: auto, on or off (JSON and completion stay uncolored)
--debugbooldefault: false- Write diagnostic JSON events to stderr without credentials or command arguments
--environmentstringdefault: empty- Select sandbox or production for OAuth or an OAuth dry run; API keys determine their own environment
--mapstringdefault: empty- List the command tree without executing a command: tree, compact, paths or json
--no-inputbooldefault: false- Disable interactive prompts (also enforced in CI and without a terminal)
--output,-ostringdefault: text- Output format: text or json
--profilestringdefault: empty- Use a profile for this command (overrides RAIMS_PROFILE and the saved default)
Request delivery of a payment link by email.
POST /v1/payment_links/{id}/send_email
Uses https://api.raims.com and the credential referenced by the selected profile. The API validates the credential's company, environment and permissions. API keys determine their own environment; --environment is available only with OAuth.
Use --dry-run to validate and preview the request without reading a profile, loading credentials or contacting the API. Add --environment to preview an OAuth request; without it, the preview uses API-key authentication and has no environment header.
OAuth environments accepted by this operation: Sandbox, Production.
HTTP 202 means the request is pending. Inspect the returned resource before repeating an operation; this command does not wait for completion.Command example
Shell
raims --profile PROFILE --output json payment-links send-email ID --dry-runraims payment-links update
Update a payment link
Shell
raims payment-links update ID [flags]--body-nullstringArraydefault: []- Set a nullable JSON body field to null by its JSON name (repeat for each field; cannot be combined with --data-file)
--cancel-redirect-urlstringdefault: empty- Set JSON body field cancel_redirect_url (string, nullable)
--clear-cancel-redirect-urlbooldefault: false- Set JSON body field clear_cancel_redirect_url (boolean)
--clear-success-redirect-urlbooldefault: false- Set JSON body field clear_success_redirect_url (boolean)
--data-filestringdefault: empty- Read the JSON request body from a UTF-8 file, or '-' for stdin
--dry-runbooldefault: false- Validate and preview the request without credentials or network access
--help,-hbooldefault: false- help for update
--idempotency-keystringdefault: empty- Reuse this optional idempotency key when retrying the same request
--is-activebooldefault: false- Set JSON body field is_active (boolean)
--payment-method-typesintegerArraydefault: empty- Set JSON body field payment_method_types (array<integer>, repeat the option for each item, nullable)
--show-headersbooldefault: false- Show public response headers without credentials or cookies
--success-redirect-urlstringdefault: empty- Set JSON body field success_redirect_url (string, nullable)
--timeoutdurationdefault: 1m0s- Total request timeout, including retries (for example 30s or 2m)
--colorstringdefault: auto- Terminal colors: auto, on or off (JSON and completion stay uncolored)
--debugbooldefault: false- Write diagnostic JSON events to stderr without credentials or command arguments
--environmentstringdefault: empty- Select sandbox or production for OAuth or an OAuth dry run; API keys determine their own environment
--mapstringdefault: empty- List the command tree without executing a command: tree, compact, paths or json
--no-inputbooldefault: false- Disable interactive prompts (also enforced in CI and without a terminal)
--output,-ostringdefault: text- Output format: text or json
--profilestringdefault: empty- Use a profile for this command (overrides RAIMS_PROFILE and the saved default)
Update a payment link.
PATCH /v1/payment_links/{id}
Uses https://api.raims.com and the credential referenced by the selected profile. The API validates the credential's company, environment and permissions. API keys determine their own environment; --environment is available only with OAuth.
Use --dry-run to validate and preview the request without reading a profile, loading credentials or contacting the API. Add --environment to preview an OAuth request; without it, the preview uses API-key authentication and has no environment header.
OAuth environments accepted by this operation: Sandbox, Production.
Read the JSON request body with --data-file PATH, or --data-file - for standard input. You can also provide the body options listed below. Repeat array options for each item. Do not combine file input with body options. Only supplied fields are sent. When listed, --body-null FIELD sends an explicit null for a nullable field. Array size and uniqueness follow the endpoint contract. Objects without dedicated body options and arrays of objects use file input.
JSON body fields:
cancel_redirect_url string optional, nullable
clear_cancel_redirect_url boolean optional
clear_success_redirect_url boolean optional
is_active boolean optional
payment_method_types array<integer> optional, nullable; allowed: 1, 2
success_redirect_url string optional, nullable
Nested requirements apply when the parent object is present, or for each supplied array item. Omit an optional field to leave it unspecified; null is accepted only for nullable fields.
JSON body example (save as request.json):
{
"clear_success_redirect_url": true,
"cancel_redirect_url": "https://loja.example.com/pedido"
}
Example values are illustrative. Replace resource IDs and review the request before sending it.Command example
Shell
raims --profile PROFILE --output json payment-links update ID --data-file request.json --dry-run
raims payment-links update ID --cancel-redirect-url="https://loja.example.com/pedido" --dry-run