setCVV operation

This page's content:

Endpoints

https://api.ebanx.com.br/ws/token/setCVV

https://staging.ebanx.com.br/ws/token/setCVV

HTTP Method

POST

Response

JSON

The token operation is used to create a token for a given credit card to be used for recurrent payments.

For this method, you will need to wrap the request parameters in a JSON object and send them as the value of a parameter called request_body.

It’s important to know that the tokens expire after 14 months of its last use.
Notice: To generate the token and check the credit card authenticity, EBANX creates a temporary transaction that will not be captured.

The setCVV operation is used to temporarily associate a CVV with an existing token. This CVV will be used by the next request made with the associated token and then discarded.

The setCVV operation is useful for one-click payments, where you already have the customer’s credit card information and cannot send the CVV from your server.

For this method, you will need to wrap the request parameters in a JSON object and send them as the value of a parameter called request_body.

Request parameters

public_integration_key string, length 100, required

Your unique and public integration key. You can do a token operation using this key instead of the integration key when the request is from the client of your customer (browser, app, etc…). By doing this,
you don’t have to deal directly with the credit card information of your customer.

token string, length 32-128, unique, required

The token that you want to associate the CVV with.

card_cvv string, length 3-4, required

Credit card security code.

Response parameters

status string

The status of the request (SUCCESS or ERROR).

token string, length 32-128, unique

The token specified in the request.

masked_card_number string, length 14-19

The masked credit card number. This can be stored and shown to the customer.

First Steps

Integration Methods

Sandbox Testing