Revolut - Schedule Payment

Description

This module allows scheduling a payment for a future date in Revolut Business. Unlike revolutCreatePayment, this module mandatorily requires a future execution date.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Revolut credentials
account_id	string	Yes	Source account UUID
counterparty_id	string	Yes	Destination counterparty UUID
counterparty_account_id	string	No	Specific destination account UUID
amount	number	Yes	Amount to transfer
currency	string	Yes	Currency (EUR, USD, GBP)
schedule_for	string	Yes	Execution date (YYYY-MM-DD)
reference	string	No	Payment reference/concept
title	string	No	Identifying title

Credentials

This module requires Revolut Business type credentials with the following fields:

Field	Description
access_token	Revolut Business API access token
sandbox	Sandbox mode for testing (true/false)

Output

{
  "success": true,
  "payment": { ... },
  "payment_id": "a1b2c3d4-...",
  "state": "pending",
  "amount": 5000.00,
  "currency": "EUR",
  "counterparty_id": "cp-xyz789",
  "request_id": "req-unique-123",
  "scheduled_for": "2024-02-01",
  "days_until_execution": 15,
  "created_at": "2024-01-15T10:30:00Z",
  "message": "Pago programado a1b2c3d4-...: EUR 5000 para 2024-02-01 (15 dias)"
}

Use Cases

1. Payroll payments: Schedule monthly payments to employees
2. Supplier payments: Schedule payments according to invoice due dates
3. Rent: Automate monthly rent payments
4. Subscriptions: Pay services on specific dates
5. Tax payments: Schedule tax payments on deadline dates

Validations

• The date must be in the future (cannot schedule for today or past days)
• The source account must have sufficient funds at the time of execution
• The counterparty must exist previously

Behavior

• Scheduled payments execute at 00:00 UTC on the indicated date
• A request_id is automatically generated to guarantee idempotency
• The initial status is “pending” until executed
• The scheduled payment can be canceled before the execution date

Usage Example

{
  "credentials_id": "revolut_empresa",
  "account_id": "a1b2c3d4-...",
  "counterparty_id": "cp-xyz789",
  "amount": 5000.00,
  "currency": "EUR",
  "schedule_for": "2024-02-01",
  "reference": "Alquiler oficina - Febrero 2024"
}

API Used

• API: Revolut Business API
• Endpoint: POST /api/1.0/pay
• Documentation: https://developer.revolut.com/docs/business/payments

Notes

• Unlike revolutCreatePayment, this module mandatorily requires schedule_for
• Useful for automating recurring treasury flows
• Consider timezone: execution is in UTC

Related Nodes

• RevolutCreatePayment: Create immediate payments
• RevolutCreateCounterparty: Create the destination counterparty
• RevolutGetAccounts: Get source account ID
• RevolutGetTransactions: View the scheduled payment in the history