Profile and payment method status
Check the statuses a payment profile and the associated payment methods can go through.
Profile status
status | Description |
PENDING | This is the initial status when creating the profile with cards as payment method, or if it is created without any payment method. It will remain in this status until the test payment is made, when it will change to READY or CANCELLED status. |
READY | This status indicates that the profile has a valid card identification and was created successfully. This status may change in the future: it can change to CANCELLED or return to PENDING status if all payment methods are modified or removed. |
CANCELLED | Status indicating that the profile was canceled due to not having an approved payment method, being unable to query the associated payment method, or because the cancellation was requested by the customer. This status cannot be modified. |
Payment method status
When adding a payment method to a profile, the API automatically performs its validation to verify if it can be used in future charges. The result of this validation is indicated by the status field, which shows the current status of the payment method.
status | Description |
PENDING | Indicates that the payment method is still in the registration process. This status is common in approved payments whose response does not include the card_id, as the card is still being registered asynchronously. |
READY | The payment method was successfully validated and is available to be used in charge attempts. |
REJECTED | The payment method could not be validated. This occurs when the test charge fails or when the card does not meet the necessary criteria to be used. |
DISABLED | The payment method has been disabled and cannot be used for new charges. This status may occur due to user decision or expiration, for example. |
