Overview
This node integrates with the Pagar.me API to manage payment operations, primarily focusing on creating payments. It supports creating payments either by providing detailed payment fields or by submitting a full payment JSON object. This node is useful for automating credit card payment processing, including capturing payments immediately, handling installments, and customizing card statement descriptors. Practical examples include charging a customer's credit card for an online purchase or processing installment payments.
Use Case Examples
- Create a payment by specifying card details and amount to charge a customer immediately.
- Submit a full payment JSON object to create a complex payment order with multiple items and charges.
Properties
| Name | Meaning |
|---|---|
| Input Mode | Choose whether to provide payment data via individual fields or as a raw JSON object. |
| Payment JSON | Full payment object in JSON format according to Pagar.me API, used when Input Mode is JSON. |
| Amount (in cents) | Amount to charge in cents, required when Input Mode is Fields. |
| Installments | Number of installments for the payment, used when Input Mode is Fields. |
| Capture | Boolean flag indicating whether to capture the payment immediately, used when Input Mode is Fields. |
| Statement Descriptor | Text to appear on the card statement, used when Input Mode is Fields. |
| Card Number | Card primary account number (PAN) without spaces, required when Input Mode is Fields. |
| Holder Name | Full name of the card holder, required when Input Mode is Fields. |
| Holder Document | Document number (CPF/CNPJ) of the card holder, used when Input Mode is Fields. |
| Expiration Month | Two-digit expiration month (MM) of the card, required when Input Mode is Fields. |
| Expiration Year | Two-digit expiration year (YY) of the card, required when Input Mode is Fields. |
| CVV | Card security code, required when Input Mode is Fields. |
| Brand | Card brand such as Visa or MasterCard, used when Input Mode is Fields. |
Output
JSON
json- The JSON response from the Pagar.me API representing the created payment order or error details.
Dependencies
- Requires Pagar.me API credentials including an API key and optionally a public key for tokenization.
Troubleshooting
- Common issues include invalid or missing API credentials, malformed JSON input, or missing required fields when using the fields input mode.
- Error messages from the Pagar.me API are propagated with HTTP status codes and details; ensure the API key is correct and the input data conforms to the API specifications.
- For tokenization operations, a public key is required; missing this will cause errors.
Links
- Pagar.me Orders API Documentation - Official documentation for creating and managing orders/payments via Pagar.me API.