QPay Ruby SDK

gem "qpay"

require "qpay"

# Configure from environment variables
config = QPay::Config.from_env

# Or configure manually
config = QPay::Config.new(
  base_url: "https://merchant.qpay.mn",
  username: "YOUR_USERNAME",
  password: "YOUR_PASSWORD",
  invoice_code: "YOUR_INVOICE_CODE",
  callback_url: "https://yoursite.com/payments/callback"
)

# Create a client (handles authentication automatically)
client = QPay::Client.new(config: config)

# Create an invoice
invoice = client.create_simple_invoice(
  QPay::CreateSimpleInvoiceRequest.new(
    invoice_code: config.invoice_code,
    sender_invoice_no: "ORDER-001",
    invoice_receiver_code: "terminal",
    invoice_description: "Payment for Order #001",
    amount: 10_000,
    callback_url: config.callback_url
  )
)

puts invoice.invoice_id      # => "abc123..."
puts invoice.qpay_short_url  # => "https://qpay.mn/s/..."
puts invoice.qr_text         # => QR code data for rendering

config = QPay::Config.from_env

config = QPay::Config.new(
  base_url: "https://merchant.qpay.mn",
  username: "YOUR_USERNAME",
  password: "YOUR_PASSWORD",
  invoice_code: "YOUR_INVOICE_CODE",
  callback_url: "https://yoursite.com/callback"
)

# Get a new token pair
token = client.get_token
puts token.access_token
puts token.refresh_token
puts token.expires_in

# Refresh the current token
token = client.refresh_token

invoice = client.create_invoice(
  QPay::CreateInvoiceRequest.new(
    invoice_code: "INV_CODE",
    sender_invoice_no: "ORDER-001",
    sender_branch_code: "BRANCH01",
    sender_branch_data: QPay::SenderBranchData.new(
      register: "REG001",
      name: "Main Branch",
      email: "branch@company.mn",
      phone: "77001234",
      address: QPay::Address.new(
        city: "Ulaanbaatar",
        district: "Khan-Uul",
        street: "Peace Avenue 123"
      )
    ),
    sender_staff_data: QPay::SenderStaffData.new(
      name: "John",
      email: "john@company.mn",
      phone: "88001234"
    ),
    invoice_receiver_code: "terminal",
    invoice_receiver_data: QPay::InvoiceReceiverData.new(
      register: "AA12345678",
      name: "Customer Name",
      email: "customer@example.com",
      phone: "99001234"
    ),
    invoice_description: "Order #001 - 2 items",
    amount: 50_000,
    callback_url: "https://yoursite.com/callback",
    lines: [
      QPay::InvoiceLine.new(
        tax_product_code: "TAX001",
        line_description: "Product A",
        line_quantity: 2,
        line_unit_price: 25_000
      )
    ],
    transactions: [
      QPay::Transaction.new(
        description: "Payment for order",
        amount: 50_000,
        accounts: [
          QPay::Account.new(
            account_bank_code: "050000",
            account_number: "1234567890",
            account_name: "Company Account",
            account_currency: "MNT",
            is_default: true
          )
        ]
      )
    ]
  )
)

puts invoice.invoice_id
puts invoice.qr_text
puts invoice.qr_image         # Base64-encoded QR image
puts invoice.qpay_short_url

# Deep links for mobile bank apps
invoice.urls.each do |url|
  puts "#{url.name}: #{url.link}"
end

invoice = client.create_simple_invoice(
  QPay::CreateSimpleInvoiceRequest.new(
    invoice_code: "INV_CODE",
    sender_invoice_no: "ORDER-002",
    invoice_receiver_code: "terminal",
    invoice_description: "Quick payment",
    sender_branch_code: "BRANCH01",
    amount: 5_000,
    callback_url: "https://yoursite.com/callback"
  )
)

invoice = client.create_ebarimt_invoice(
  QPay::CreateEbarimtInvoiceRequest.new(
    invoice_code: "INV_CODE",
    sender_invoice_no: "ORDER-003",
    sender_branch_code: "BRANCH01",
    invoice_receiver_code: "terminal",
    invoice_description: "Tax invoice",
    tax_type: "1",
    district_code: "001",
    callback_url: "https://yoursite.com/callback",
    lines: [
      QPay::EbarimtInvoiceLine.new(
        tax_product_code: "TAX001",
        line_description: "Taxable product",
        line_quantity: 1,
        line_unit_price: 10_000,
        classification_code: "CLS001"
      )
    ]
  )
)

client.cancel_invoice("INVOICE_ID")

payment = client.get_payment("PAYMENT_ID")

puts payment.payment_id
puts payment.payment_status    # => "PAID"
puts payment.payment_amount    # => 10000
puts payment.payment_currency  # => "MNT"
puts payment.payment_wallet
puts payment.payment_date
puts payment.transaction_type
puts payment.object_type
puts payment.obj_id

# Card transactions
payment.card_transactions.each do |ct|
  puts "Card: #{ct.card_number} - #{ct.amount} #{ct.currency}"
end

# P2P transactions
payment.p2p_transactions.each do |pt|
  puts "Bank: #{pt.account_bank_name} - #{pt.amount} #{pt.currency}"
end

result = client.check_payment(
  QPay::PaymentCheckRequest.new(
    object_type: "INVOICE",
    obj_id: "INVOICE_ID",
    offset: QPay::Offset.new(page_number: 1, page_limit: 10)
  )
)

puts result.count        # Number of payments
puts result.paid_amount  # Total paid amount

result.rows.each do |row|
  puts "#{row.payment_id}: #{row.payment_status} - #{row.payment_amount}"
end

payments = client.list_payments(
  QPay::PaymentListRequest.new(
    object_type: "INVOICE",
    obj_id: "INVOICE_ID",
    start_date: "2024-01-01",
    end_date: "2024-12-31",
    offset: QPay::Offset.new(page_number: 1, page_limit: 20)
  )
)

puts payments.count

payments.rows.each do |item|
  puts "#{item.payment_id}: #{item.payment_amount} #{item.payment_currency} (#{item.payment_status})"
end

# Without request body
client.cancel_payment("PAYMENT_ID")

# With callback and note
client.cancel_payment("PAYMENT_ID", request: QPay::PaymentCancelRequest.new(
  callback_url: "https://yoursite.com/cancel-callback",
  note: "Customer requested cancellation"
))

# Without request body
client.refund_payment("PAYMENT_ID")

# With callback and note
client.refund_payment("PAYMENT_ID", request: QPay::PaymentRefundRequest.new(
  callback_url: "https://yoursite.com/refund-callback",
  note: "Refund for defective product"
))

ebarimt = client.create_ebarimt(
  QPay::CreateEbarimtRequest.new(
    payment_id: "PAYMENT_ID",
    ebarimt_receiver_type: "CITIZEN",
    ebarimt_receiver: "AA12345678",
    district_code: "001",
    classification_code: "CLS001"
  )
)

puts ebarimt.id
puts ebarimt.amount
puts ebarimt.vat_amount
puts ebarimt.barimt_status
puts ebarimt.ebarimt_qr_data
puts ebarimt.ebarimt_lottery

ebarimt.barimt_items.each do |item|
  puts "#{item.name}: #{item.amount}"
end

ebarimt = client.cancel_ebarimt("PAYMENT_ID")

puts ebarimt.barimt_status  # => "CANCELED"

begin
  client.create_simple_invoice(request)
rescue QPay::Error => e
  puts e.message      # => "qpay: INVOICE_LINE_REQUIRED - Invoice lines are required (status 400)"
  puts e.status_code  # => 400
  puts e.code         # => "INVOICE_LINE_REQUIRED"
  puts e.raw_body     # => Raw JSON response body
end

begin
  client.get_payment("some_id")
rescue => e
  qpay_err, is_qpay = QPay.qpay_error?(e)
  if is_qpay
    puts "QPay error: #{qpay_err.code}"
  else
    puts "Other error: #{e.message}"
  end
end

rescue QPay::Error => e
  case e.code
  when QPay::AUTHENTICATION_FAILED
    # Re-authenticate
  when QPay::INVOICE_NOTFOUND
    # Handle missing invoice
  when QPay::INVOICE_PAID
    # Invoice already paid
  when QPay::PAYMENT_NOTFOUND
    # Handle missing payment
  when QPay::PAYMENT_ALREADY_CANCELED
    # Payment was already canceled
  when QPay::INVALID_AMOUNT
    # Amount out of range
  when QPay::PERMISSION_DENIED
    # Access denied
  when QPay::EBARIMT_NOT_REGISTERED
    # Ebarimt not registered
  end
end