E‑TALKv1 card integration docs
IKỌBỌ Marketplacev1 card integration docs
Home

Getting Started

Welcome to V1 Card payment integration. Before proceeding, ensure you meet these requirements:

Prerequisites

  • WooCommerce (v5.0+)
  • WordPress (v5.6+)
  • PHP (v7.4+)
  • SSL Certificate (HTTPS required)

What You'll Need

  • Merchant ID
  • API Key
  • V1 Card Wallet Address
  • Admin Access

Pro Tip: Keep your API key secure like a password. Never expose it in frontend code.

Installation

WordPress Dashboard

  1. Download the plugin ZIP from your merchant dashboard
  2. Go to Plugins → Add New
  3. Click Upload Plugin
  4. Select the file and click Install Now
  5. Activate the plugin

Manual FTP Upload

  1. Unzip the plugin files
  2. Connect via FTP/SFTP to /wp-content/plugins/
  3. Upload the entire folder
  4. Activate under Plugins

Command Line Installation

wp plugin install https://e-talk.xyz/downloads/v1-card-plugin.zip --activate

Or for local files:

wp plugin install /path/to/v1-card-plugin.zip --activate

Configuration

1

Enable Payment Method

Navigate to WooCommerce → Settings → Payments and enable "V1 Card"

2

Enter Credentials

  • Merchant ID: From your dashboard
  • API Key: Your secret key
  • Wallet Address: For receiving payments
3

Additional Settings

  • Transaction Speed: Instant confirmations
  • Checkout Logo: Customize payment button
  • Callback URL: For payment notifications

Payment Flow

1

Customer selects
V1 Card at checkout

2

System generates
payment request

3

Customer pays via
card-to-card transfer

4

Payment confirmed
instantly (0% fees)

Zero Fees: Enjoy instant card-to-card transfers with no transaction fees.

Advanced Features

Receive real-time payment notifications:

{
    "event": "payment.confirmed",
    "order_id": "WC123",
    "amount": "1.5",
    "tx_hash": "0xabc...123"
}

Implement on your server:

  1. Create an API endpoint
  2. Verify the signature header
  3. Update your order system

Override default templates:

your-theme/woocommerce/v1-card/checkout.php

Custom CSS example:

.v1-card-payment-btn {
    background: #FF6A00;
    border-radius: 8px;
}

Troubleshooting

Payment Not Detected

  • Check transaction status
  • Verify wallet address matches
  • Ensure server time is synchronized

Plugin Not Appearing

  • Confirm WooCommerce is active
  • Check currency is supported
  • Reinstall the plugin

Callback Issues

  • Test endpoint manually
  • Check server error logs
  • Verify no firewall blocks

Frequently Asked Questions

All payments are instant card-to-card transfers with immediate confirmation.

No - V1 Card offers 0% fees on all transactions.

All major debit and credit cards are supported for instant transfers.

Developer API Reference

For advanced integrations, V1 Card provides REST API endpoints for direct interaction with our payment system.

Authentication Required: All API requests must include your API key in the X-API-KEY header.

X-API-KEY: your_merchant_api_key_here
GET /etk/v1/price

Retrieve the current ETK price in USD along with the last updated timestamp.

Authentication

No API key required for this endpoint. This endpoint is public and can be accessed directly.

Example Request

GET https://e-talk.xyz/wp-json/etk/v1/price

Success Response

{
    "price": 0.7922,
    "formatted_price": "$0.7922",
    "percent_change": -0.0212,
    "formatted_change": "-0.0212%",
    "timestamp": "2025-08-25 02:51:58"
}

Response Fields

Field Type Description
price float Raw ETK price in USD
formatted_price string Price formatted with a dollar sign
percent_change float Price change in percent since last update (decimal)
formatted_change string Percent change formatted with a percent sign
timestamp string ISO timestamp of the last price update
POST /v1-card/v1/process-payment

Initiate and process a new payment transaction.

Request Parameters

Parameter Type Required Description
amount float Yes Payment amount
order_id string Yes Unique order identifier
customer_email string No Customer's email for notifications

Example Request

{
    "amount": 1.5,
    "order_id": "ORDER_12345",
    "customer_email": "customer@example.com"
}

Success Response

{
    "success": true,
    "payment_id": "PAY_789012",
    "amount": 1.5,
    "confirmed_at": "2023-06-15T14:22:35Z"
}

Webhook Notifications

V1 Card will send POST requests to your callback URL with payment status updates:

Payment Confirmed

{
    "event": "payment.confirmed",
    "payment_id": "PAY_789012",
    "amount": 1.5,
    "timestamp": "2023-06-15T14:22:35Z"
}

Security Note: Always verify the webhook signature using your API key.

AI