Class: Conexa::CreditCard

Inherits:
Model show all
Defined in:
lib/conexa/resources/credit_card.rb

Overview

Credit card, registered against the customer through Cielo.

Write-only. API v2 exposes POST /creditCard and nothing else — the card number and CVC live encrypted at Cielo, not in Conexa, so there is nothing to read back. Verified against a live tenant on 2026-08-12:

GET /creditCard      => 404 "Unable to resolve the request"
GET /creditCard/:id  => 404 "unable to find the requested action \"view\""

Neither is the "does not exist or you have no permission to access it" wording the API uses for a resource an account cannot see, and the collection documents a 403 for authorization — so this is the shape of the API, not a feature switched off for one tenant.

#save and #destroy are left in place but are undocumented and unverified: the collection describes only POST, and the documented behaviour of default: and enable_recurring: — re-registering a card changes which one is default, or turns recurrence off — reads as if there is no update path at all. They were not probed, because probing them means writing. Treat a 404 from either as expected rather than as a bug.

Examples:

Register a card

Conexa::CreditCard.create(
  customer_id: 127, number: '4111111111111111',
  expiration_date: '12/26', cvc: '123', name: 'JOAO DA SILVA',
  default: true, enable_recurring: true
)

Constant Summary collapse

NO_READ = 
"a API v2 não expõe leitura de cartão de crédito: só " \
"POST /creditCard é documentado, e GET /creditCard[/:id] responde 404. " \
"Os dados do cartão ficam na Cielo, não no Conexa."

Constants inherited from ConexaObject

Conexa::ConexaObject::RESOURCES

Instance Attribute Summary

Attributes inherited from ConexaObject

#attributes

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Model

all, #class_name, class_name, create, #destroy, destroy, extract_page_size_or_params, #fetch, find_by, find_by_id, #id, #primary_key, primary_key_attribute, #primary_key_name, #save, #set_primary_key, underscored_class_name

Methods included from Deprecatable

#deprecate

Methods inherited from ConexaObject

#==, #[]=, convert, #empty?, #initialize, #respond_to_missing?, #to_hash, #unsaved_attributes

Constructor Details

This class inherits a constructor from Conexa::ConexaObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Conexa::ConexaObject

Class Method Details

.show_url(*params) ⇒ Object 



52
53
54
 
# File 'lib/conexa/resources/credit_card.rb', line 52

def show_url(*params)
  ["/creditCard", *params].join '/'
end

.url(*params) ⇒ Object 



48
49
50
 
# File 'lib/conexa/resources/credit_card.rb', line 48

def url(*params)
  ["/creditCard", *params].join '/'
end

Instance Method Details

#create ⇒ self

Model#create re-fetches the created record to pick up server-side defaults. There is no read here, so the id from the response is all there is.

Returns:

  • (self) 


41
42
43
44
45
 
# File 'lib/conexa/resources/credit_card.rb', line 41

def create
  created = Conexa::Request.post(self.class.show_url, params: to_hash).call(class_name)
  set_primary_key created.attributes['id'] if created.respond_to?(:attributes)
  self
end