Skip to main content

Andromeda

Overview​

Andromeda is a global banking solution that enables businesses to accept and process international bank transfers across multiple currencies. With banking partners in Australia, United Kingdom, and Hong Kong, it provides comprehensive coverage for both local and international transactions.

Andromeda Logo

Features​

  • Multi-currency support (14+ currencies)
  • International bank transfer processing
  • Real-time transaction tracking
  • Secure payment processing
  • Global banking network
  • Instant payment notifications

Integration Requirements​

  • Banksy API Key
  • Valid callback URLs for success and failure scenarios
  • Customer email for transaction notifications

Supported Currencies​

Currencies
  • AUD - Australian Dollar
  • CAD - Canadian Dollar
  • CHF - Swiss Franc
  • CNH - Chinese Yuan
  • EUR - Euro
  • GBP - British Pound
  • HKD - Hong Kong Dollar
  • JPY - Japanese Yen
  • NOK - Norwegian Krone
  • NZD - New Zealand Dollar
  • SEK - Swedish Krona
  • SGD - Singapore Dollar
  • USD - US Dollar
  • ZAR - South African Rand

Implementation​

Payment Payload Structure​

const payload = {
  amount: number, // Payment amount
  currency: string, // Currency code (e.g., AUD, GBP, USD)
  currencyType: "andromeda", // Fixed value for Andromeda transactions
  isKycOptional: boolean, // Whether KYC is required
  customerEmail: string, // Customer's email address
  successCallback: string, // URL for successful payments
  failureCallback: string, // URL for failed payments
};

Example Implementation​

import { Banksy } from "banksy-sdk";

// Initialize the Banksy SDK with your API key
const banksy = new Banksy("your-api-key");

async function createAndromedaPayment() {
  try {
    const paymentPayload = {
      amount: 1000,
      currency: "AUD",
      currencyType: "andromeda",
      isKycOptional: true,
      customerEmail: "customer@example.com",
      successCallback: "https://your-domain.com/success",
      failureCallback: "https://your-domain.com/failure",
    };

    const payment = await banksy.createPayment(paymentPayload);
    console.log("Payment Created:", payment);

    // Redirect to payment page
    window.location.href = payment.paymentLink;
  } catch (error) {
    console.error("Payment creation failed:", error);
  }
}

Testing​

API Testing with cURL​

curl --location 'https://sandbox-api.banksy.id/sdk/payment/create' \
--header 'Content-Type: application/json' \
--header 'X-AUTH: ck_test_************738139' \
--data-raw '{
    "amount": 1000,
    "currency": "AUD",
    "currencyType": "andromeda",
    "isKycOptional": true,
    "customerEmail": "customer@example.com",
    "successCallback": "http://domain.com/success",
    "failureCallback": "http://domain.com/failure"
}'

Best Practices​

  1. Currency Selection

    • Verify currency support for the selected region
    • Use appropriate bank details for each currency
    • Consider exchange rate implications

  2. Transaction Processing

    • Include all required bank details
    • Verify account numbers before submission
    • Implement proper error handling
    • Monitor transaction status

  3. Security Considerations

    • Use HTTPS for all API calls
    • Validate all input parameters
    • Implement proper authentication
    • Monitor for suspicious activities

  4. Error Handling

    • Implement comprehensive error handling
    • Log all payment attempts
    • Provide clear error messages
    • Handle timeout scenarios

Support​

For technical support or integration assistance, please contact the Banksy support team through the official channels.