Asaas Ruby

A biblioteca Asaas Ruby tem provê um acesso a API Rest do asaas.com.br

Installation

You don't need this source code unless you want to modify the gem. If you just want to use the package, just run:

gem install asaas-ruby

Para fazer o build da gem

gem build asaas-ruby.gemspec

Changelog

• 0.2.24 - Add support to PIX billing type and fills missing CHANGELOG entries
• 0.2.23 - Add support to Ruby 2.7 and Rails 6.1
• 0.2.22 - Remove unecessary ActiveSupport version limit
• 0.2.21 - Add credit fields to Payment
• 0.2.20 - Adds debug flag to check responses
• 0.2.19 - Small fixes
• 0.2.18 - Account documents upload
• 0.2.17 - Add support to DEPOSIT billing type
• 0.2.16 - Wallet account tranfers
• 0.2.15 - Bank account tranfers

Requirements

• Ruby 2.3+.

Usage

Creating payments

require 'asaas-ruby'

Asaas.setup do |config|
  config.token = 'token'
end

asaas_client = Asaas::Client.new()

customer = Asaas::Customer.new({name: 'Thiago Diniz', cpfCnpj: '05201932419', email: '[email protected]'})
asaas_client.customers.create(customer)

charge = Asaas::Payment.new({
  customer: customer.id,
  dueDate: '2019-10-10',
  billingType: 'BOLETO', # PIX CREDIT_CARD ....
  description: "Teste pagamento",
  value: (Float Integer BigDecimal String).to_s,  # 100.00
  postalService: false
})

asaas_client.payments.create(charge)

Pix dinâmico qr & code

    new_payment = Asaas::Payment.new({
      billingType: "PIX",
      customer: customer.id,                 # "cus_000005219617",
      value: value,                          #  Money.to_s 100.00
      description: description
    })
    payment = asaas.payments.create(new_payment)

    # Check if payment creation was successful and it's a PIX payment
    # (payment will be an Asaas::Payment model or Asaas::Entity::Payment depending on API version and success)
    if payment && !payment.is_a?(Asaas::Entity::Error) && payment.id # && payment.billingType == "PIX"
      puts "Payment created successfully with ID: #{payment.id}"

      # Fetch the PIX QR Code
      qr_code_data = asaas.payments.pix_qr_code(payment.id)

      if qr_code_data.is_a?(Asaas::Entity::PaymentPix)
        puts "PIX QR Code details fetched successfully:"
        puts "  Encoded Image: #{qr_code_data.encodedImage ? qr_code_data.encodedImage[0..30] + '...' : 'N/A'}" # Truncated for brevity
        puts "  Payload: #{qr_code_data.payload}"
        puts "  Expiration Date: #{qr_code_data.expirationDate}"
      elsif qr_code_data.is_a?(Asaas::Entity::Error)
        puts "Error fetching PIX QR Code:"
        qr_code_data.errors.each do |error|
          puts "  Code: #{error.code}, Description: #{error.description}"
        end
      else
        puts "Unexpected response when fetching PIX QR Code."
      end
    else
      puts "Failed to create PIX payment or payment ID is missing."
      if payment.is_a?(Asaas::Entity::Error)
        payment.errors.each do |error|
          puts "  Error Code: #{error.code}, Description: #{error.description}"
        end
      end
    end

Pix estático

TODO

Transparent Checkout

Note: asaas uses CCV (others: CVV/CVC)

    charge = Asaas::Payment.new({
      customer: customer.id,                     # "cus_000005219613",
      billingType: 'CREDIT_CARD',
      value: lots_money,                         #  Money.to_s 100.00
      dueDate: "%Y-%m-%d",                       # "2023-07-21"
      # creditCard:
      creditCardHolderName: card.name,           #  jose da silva sauro
      creditCardNumber: card.number,             # "5162306219378829"
      creditCardExpiryMonth: card.month,         # "05"
      creditCardExpiryYear: card.year,           # "2024"
      creditCardCcv: card.cvv,                   # "318" NOTE: asaas call CCV, we call CVV
      # creditCardHolder:
      creditCardHolderFullName: card.holder,     # "Marcelo Henrique Almeida"
      creditCardHolderEmail: card.email,         # "[email protected]"
      creditCardHolderCpfCnpj: card.doc,         # "24971563792"
      creditCardHolderAddressNumber: card.addr,  # "277"
      creditCardHolderPostalCode: card.zip,      # "89223-005"
      creditCardHolderAddressNumber: card.addr,  # "277"
      creditCardHolderAddressComplement: "",     # card.compl,
      creditCardHolderMobilePhone: card.phone,   # "47 99999-9999"
      creditCardHolderPhone: ""
      # },
      remoteIp: card.ip                          # user.last_ip
    })

    @asaas.payments.create(charge)