Aller au contenu principal

Transactions & Payments

Manage your payments and view transaction history.

Overview​

Track all your payments, invoices, and usage on the Payments dashboard.

Viewing Transactions​

Endpoint: GET /paygate/transactions

List all your transactions:

curl -X GET "https://admin.yodi.tg/api/paygate/transactions" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "message": "SUCCESS",
  "error": false,
  "data": [
    {
      "id": "txn_abc123",
      "date": "2026-06-24",
      "amount": 99,
      "currency": "USD",
      "type": "subscription",
      "planName": "Professional",
      "status": "paid",
      "invoiceUrl": "https://..."
    },
    {
      "id": "txn_def456",
      "date": "2026-05-24",
      "amount": 99,
      "currency": "USD",
      "type": "subscription",
      "planName": "Professional",
      "status": "paid",
      "invoiceUrl": "https://..."
    }
  ],
  "status": 200
}

Transaction Details​

Endpoint: GET /paygate/transactions/{id}

Get details of a specific transaction:

curl -X GET "https://admin.yodi.tg/api/paygate/transactions/txn_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Invoices​

Download Invoice​

Endpoint: GET /paygate/transactions/{id}/invoice

Download a PDF invoice for a transaction:

curl -X GET "https://admin.yodi.tg/api/paygate/transactions/txn_abc123/invoice" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o invoice.pdf

Auto-Email Invoices​

Enable invoice delivery to your email in account settings.

Payment Methods​

Supported Methods​

YODI accepts multiple payment methods for flexible billing:

1. Mobile Money​

Instant payment from your phone

  • Available in African countries
  • Providers: MTN Money, Orange Money, Airtel Money, etc.
  • Instant confirmation
  • Low transaction fees

2. Bank Card​

Secure card payment

  • Visa, Mastercard, American Express
  • Encrypted payment processing
  • 3D Secure authentication
  • Receipt issued immediately

3. Bank Transfer (Enterprise)​

For large volumes and enterprises

  • Direct bank transfer
  • Monthly invoicing
  • Custom payment terms
  • Contact sales team

Add Payment Method​

  1. Log in to dashboard
  2. Go to Settings → Payment Methods
  3. Click Add Payment Method
  4. Select your preferred payment method
  5. Follow the payment provider's instructions

Payment Status​

Endpoint: GET /paygate/payment-status

Track the status of your payments:

  • Pending: Payment submitted, awaiting confirmation
  • Completed: Payment successful
  • Failed: Payment declined, retry or use another method
  • Expired: Payment link expired (request new one)

Supported Currencies​

  • USD (US Dollar)
  • FCFA (West African CFA Franc - XOF)
  • EUR (Euro)
  • GBP (British Pound)
  • Local currencies (via Mobile Money providers)

Promo Codes​

Validate Promo Code​

Endpoint: POST /promos/validate

Check if a promo code is valid:

curl -X POST "https://admin.yodi.tg/api/promos/validate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SAVE50"
  }'

Response:

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "valid": true,
    "code": "SAVE50",
    "discountType": "percentage",
    "discountValue": 50,
    "discountedAmount": 5000
  },
  "status": 200
}

Apply Promo Code​

Endpoint: POST /promos/apply

Apply a promo code to your account:

curl -X POST "https://admin.yodi.tg/api/promos/apply" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SAVE50"
  }'

Payment Status​

Check Payment Status​

Endpoint: GET /paygate/payment-status

curl -X GET "https://admin.yodi.tg/api/paygate/payment-status" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "status": "completed",
    "method": "mobile_money",
    "currency": "USD"
  },
  "status": 200
}

Refunds & Disputes​

For refund requests or payment disputes:

  1. Contact support@yodi.tg
  2. Provide transaction ID
  3. Explain the issue
  4. Support will review within 3 business days

FAQ​

Q: When will I be charged? A: You're charged on your subscription renewal date. First charge occurs immediately upon subscription.

Q: Can I change my payment method? A: Yes, through Settings → Payment Methods.

Q: Do you offer invoices? A: Yes, all transactions have downloadable invoices.

Q: What currencies do you accept? A: Primarily USD, XOF, and other major currencies depending on your region.

Next Steps​