Currencytransfer icon

Currencytransfer

Easy and simple currency conversion

Actions19

Payment → Create

AI-generated

Overview

This node creates a payment associated with a trade in the Currency Transfer system. It allows users to specify details such as the trade identifier, payment amount, beneficiary, payment reference, and purpose. This node is useful for automating payment creation in financial workflows, such as paying beneficiaries for trades or managing payment orders programmatically.

Use Case Examples

  1. Creating a payment for a specific trade with a defined amount and beneficiary UUID.
  2. Adding a reference note to a payment order for tracking purposes.
  3. Specifying the purpose of payment when required by certain partners or countries.

Properties

Name Meaning
Trade UUID Identifier of the trade to which the payment is related.
Amount Amount of the payment. If set to 0, the payment will be deleted.
Reference A reference string added to the payment order by the broker, limited to 25 characters with specific allowed characters.
Beneficiary UUID UUID of the beneficiary to be paid.
Purpose of Payment Purpose of the payment, required for some partners or countries. Can be checked via a specific endpoint.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • paymentId - Unique identifier of the created payment.
  • status - Status of the payment creation operation.
  • tradeUUID - The trade identifier associated with the payment.
  • amount - The amount specified for the payment.
  • beneficiaryUUID - UUID of the beneficiary who will receive the payment.
  • reference - Reference note added to the payment order.
  • purpose - Purpose of the payment if specified.

Dependencies

  • An API key credential for authenticating with the Currency Transfer API.

Troubleshooting

  • Ensure the Trade UUID and Beneficiary UUID are valid and exist in the system to avoid errors.
  • If the amount is set to 0, the payment will be deleted instead of created, which might be unintended.
  • Check the purpose of payment requirement for certain beneficiaries or countries to avoid validation errors.
  • If SSL certificate validation fails and the 'Ignore SSL Issues' option is not enabled, the request will be rejected.
  • Timeout settings should be adjusted based on network conditions to prevent premature request abortion.

Discussion