ATH Móvil Tool icon

ATH Móvil Tool

Process payments, refunds, and transactions using ATH Móvil, Puerto Rico's mobile payment platform
Join our community

Actions6

Overview

This node integrates with ATH Móvil, Puerto Rico's mobile payment platform, to perform various payment-related operations such as creating payments, finding payment status, authorizing payments, updating phone numbers, issuing refunds, and canceling payments. It is useful for businesses that want to automate and manage their payment transactions through ATH Móvil within their workflows. For example, a business can create a payment transaction for a customer, check the payment status, authorize the payment once confirmed, and handle refunds or cancellations if needed.

Use Case Examples

  1. Create a payment transaction by providing the customer's ATH Móvil phone number, total amount, item details, and metadata.
  2. Find the status of a payment using the ecommerce transaction ID.
  3. Authorize a payment after customer confirmation using the authorization token.
  4. Update the phone number associated with an existing payment transaction for customer contact changes.

Properties

Name Meaning
Phone Number The ATH Móvil account phone number to which the payment is directed.
Total The total payment amount, ranging from 1.00 to 1500.00.
Items A collection of items included in the payment, each with name, description, price, quantity, tax, and metadata.
Metadata 1 First transaction metadata field, limited to 40 characters.
Metadata 2 Second transaction metadata field, limited to 40 characters.
Additional Fields Optional fields including transaction timeout (120-600 seconds), total tax amount, and subtotal amount.

Output

JSON

  • ecommerceId - The unique transaction ID returned after creating a payment.
  • auth_token - Authorization token used for subsequent operations like authorizing or refunding payments.
  • status - Current status of the payment transaction (e.g., OPEN, CONFIRM, COMPLETED, CANCEL).
  • details - Additional details about the payment transaction or operation result.

Dependencies

  • Requires ATH Móvil API credentials including a public token and optionally a private token for refund operations.

Troubleshooting

  • Common issues include invalid or missing credentials, exceeding allowed payment amount limits, or providing incorrect transaction IDs or authorization tokens.
  • Error messages from the ATH Móvil API are parsed and returned with descriptive messages and error codes to help diagnose issues.
  • Ensure that required fields like phone number, total amount, and metadata are correctly provided and within specified limits.
  • Timeout values must be between 120 and 600 seconds; exceeding these limits will cause errors.

Links

Discussion