This endpoint enables merchants to initiate payment transactions using credit cards. It processes payment requests by securely handling card information and routing the transaction to the appropriate payment processor based on availability, success rates, and country-specific rules.
The charge process supports various payment scenarios including one-time payments, recurring billing, and installment plans. The system automatically handles currency conversion, international processing, and compliance with local regulations.
Parameters: wallet_uuid (str): Required. The wallet identifier that will receive the funds. type_charge (str): The type of charge to create (default: "credit_card"). amount (float): Required. The transaction amount. currency (str): Required. The currency code (e.g., "BRL", "USD", "MXN"). card (object): Required. Card information including number, holder name, expiration date, and security code. installments (int): Optional. Number of installments for the payment. description (str): Optional. Description of the charge. metadata (object): Optional. Additional information associated with the transaction.
Returns: 200 OK: The transaction was successfully initiated. Returns the transaction details. 400 Bad Request: Invalid input parameters, card validation failed, or the wallet not found. 402 Payment Required: The payment was declined by the processor.
Note: Card details are securely handled and not stored in plain text. For recurring transactions, consider using the token-card endpoint to generate a secure token instead of repeatedly sending card details.