Skip to main content

Triangulum

Overview​

Triangulum is a PayID payments provider that specializes in processing Australian Dollar (AUD) transactions. It offers fast and secure payment processing with an average confirmation time of just 2 minutes, available 24 hours a day.

Triangulum Logo

Features​

  • PayID payment support
  • AUD currency support only
  • 24/7 availability
  • Fast transaction processing (average 2 minutes confirmation time)
  • Secure payment processing
  • Instant payment notifications
  • Transaction amount range: 20 to 2500 AUD

Integration Requirements​

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

Supported Currencies​

Currencies
  • AUD - Australian Dollar
warning

The isKycOptional parameter should be set to true for Triangulum payments, as it is mandatory.

Accepted Payment Methods​

Supports PayID payments in Australia:

  • Fast and secure transactions
  • Available 24/7
  • Transaction limits: 20-2500 AUD

Payment Verification​

For payment verification, users need to provide their PayID transaction reference number.

warning

The transaction reference can be found in your banking app's transaction history or payment confirmation screen. This is required for payment verification.

Implementation​

Payment Payload Structure​

const payload = {
  amount: number, // Payment amount in AUD (20-2500)
  currency: "AUD", // Fixed as AUD for Triangulum
  currencyType: "triangulum", // Fixed value for Triangulum 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 createTriangulumPayment() {
  try {
    const paymentPayload = {
      amount: 100, // Amount in AUD (must be between 20-2500)
      currency: "AUD",
      currencyType: "triangulum",
      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);
    throw error;
  }
}

Best Practices​

  1. Amount Validation

    • Ensure payment amount is within the 20-2500 AUD range
    • Validate amount before submitting payment request

  2. Transaction Processing

    • Inform users about the expected 2-minute processing time
    • Implement proper timeout handling
    • Verify transaction status after the expected processing time

  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 to users
    • Handle timeout scenarios appropriately

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": 100,
    "currency": "AUD",
    "currencyType": "triangulum",
    "isKycOptional": true,
    "customerEmail": "customer@example.com",
    "successCallback": "http://domain.com/success",
    "failureCallback": "http://domain.com/failure"
}'

Support​

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