Skip to main content

Wyrapay

Overview​

Wyrapay is a specialized fiat payment provider focused on Brazil, Latin America, and Africa. It offers innovative payment processing solutions with a particular emphasis on PIX-based transactions.

Wyrapay Logo

Features​

  • PIX-based instant payments (under 3 seconds processing)
  • Cloud-based scalable platform
  • Real-time transaction processing

Integration Requirements​

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

Supported Currencies​

  • BRL

Supported Services​

Core Services
  • PIX Processing

Implementation​

Payment Payload Structure​

const payload = {
  amount: number, // Payment amount
  currency: string, // Currency code
  currencyType: "wyrapay", // Fixed value for Wyrapay 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 createWyrapayPayment() {
  try {
    const paymentPayload = {
      amount: 100,
      currency: "BRL",
      currencyType: "wyrapay",
      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);
  }
}

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

Best Practices​

  1. PIX Transactions

    • Implement proper error handling for real-time transactions
    • Verify transaction status through webhooks
    • Store PIX keys securely

  2. Security Considerations

    • Use HTTPS for all API calls
    • Implement proper authentication
    • Monitor transactions for suspicious activity
    • Regular security audits

Support​

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