v1

latestOpenAPI 3.1.02026-07-241040774.6 KB

Renovar cartão

Com o verbo HTTP POST, através do identificador do cartão (card_id) e do identificador do cliente (customer_id) ao qual o cartão está associado, é possível renovar o cartão da Wallet do cliente, utilizando a funcionalidade manual do Card Updater.

post/customers/{customer_id}/cards/{card_id}/renew

Path parameters

customer_idstring required

Código do cliente. Formato: cus_XXXXXXXXXXXXXXXX.

card_idstring required

Código do cartão. Formato: card_XXXXXXXXXXXXXXXX.

Response

200

idstring

first_six_digitsstring

last_four_digitsstring

brandstring

holder_namestring

exp_monthinteger

exp_yearinteger

statusstring

typestring

is_renewedboolean

created_atstring

updated_atstring

Example response

{
  "id": "card_MgwPAXnU7rHW5mNj",
  "first_six_digits": "519645",
  "last_four_digits": "5475",
  "brand": "Mastercard",
  "holder_name": "Tony Stark",
  "exp_month": 3,
  "exp_year": 2020,
  "status": "active",
  "type": "credit",
  "is_renewed": true,
  "created_at": "2018-06-22T22:49:48Z",
  "updated_at": "2018-06-22T22:49:48Z",
  "billing_address": {
    "zip_code": "90265",
    "city": "Malibu",
    "state": "CA",
    "country": "US",
    "line_1": "10880, Malibu Point, Malibu Central"
  },
  "customer": {
    "id": "cus_BzRmLzQHEyurPkKo",
    "name": "Tony Stark",
    "email": "203b6f70-61ec-4f30-b00a-8a1823500ab4@avengers.com",
    "document": "93095135270",
    "type": "individual",
    "created_at": "2018-06-22T21:36:49Z",
    "updated_at": "2018-06-22T21:36:49Z",
    "phones": {
      "home_phone": {
        "country_code": "55",
        "number": "000000000",
        "area_code": "21"
      },
      "mobile_phone": {
        "country_code": "55",
        "number": "000000000",
        "area_code": "21"
      }
    },
    "metadata": {
      "company": "Avengers"
    }
  }
}