sepivip/claude-skill-bog-payment-gateway/bog-payment-gateway

Claude Code and agent skill by sepivip/claude-skill-bog-payment-gateway

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Bank of Georgia (BOG) Payment Gateway API integration for accepting online payments. Use this skill when implementing BOG payment processing, creating payment orders, handling refunds, checking payment status, or integrating with BOG's OAuth authentication. Triggers include mentions of BOG, Bank of Georgia, Georgian payments, ipay.ge, or requests for payment gateway integration in Georgia.

Install

npx vskill@latest install sepivip/claude-skill-bog-payment-gateway/bog-payment-gateway

SKILL.md

The same SKILL.md was published earlier as david-li0406/meta-skill-evloving/bog-payment-gateway.

BOG Payment Gateway Integration

This skill provides guidance for integrating with the Bank of Georgia (BOG) Online Payment API.

Quick Reference

ItemValue
Auth URLhttps://oauth2.bog.ge/auth/realms/bog/protocol/openid-connect/token
API Basehttps://api.bog.ge/payments/v1
Auth MethodOAuth 2.0 Client Credentials
Data FormatJSON

IMPORTANT:

  • All callback URLs MUST use HTTPS
  • All API requests MUST include Accept-Language: ka or Accept-Language: en header

Integration Flow

  1. Authenticate - Get access token using client credentials
  2. Create Order - Submit order with basket items and callbacks
  3. Redirect - Send customer to payment page (URL from response)
  4. Handle Callback - Receive payment result at callback URL
  5. Verify - Check payment status via API

Authentication

typescript
const getAccessToken = async (clientId: string, clientSecret: string) => {
const credentials = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
const response = await fetch(
'https://oauth2.bog.ge/auth/realms/bog/protocol/openid-connect/token',
{
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Authorization': `Basic ${credentials}`
},
body: 'grant_type=client_credentials'
}
);
const { access_token, expires_in } = await response.json();
return { access_token, expires_in };
};

Core Endpoints

Create Order
POST https://api.bog.ge/payments/v1/ecommerce/orders
Authorization: Bearer {access_token}
Content-Type: application/json

Request body:

json
{
"callback_url": "https://example.com/callback",
"external_order_id": "ORDER-123",
"purchase_units": {
"currency": "GEL",
"total_amount": 100.00,
"basket": [
{
"product_id": "PROD-1",
"quantity": 1,
"unit_price": 100.00
}
]
},
"redirect_urls": {
"success": "https://example.com/success",
"fail": "https://example.com/fail"
}
}

Response includes _links.redirect.href for payment page URL.

Get Payment Details
GET https://api.bog.ge/payments/v1/receipt/{order_id}
Authorization: Bearer {access_token}
Refund Payment
POST https://api.bog.ge/payments/v1/payment/refund/{order_id}
Authorization: Bearer {access_token}
Content-Type: application/json
{"amount": 50.00} // Optional - omit for full refund

Response Codes

CodeMeaning
100Successful payment
200Successful preauthorization
101Card usage limited
102Saved card not found
103Invalid card
104Transaction limit exceeded
105Card expired
106Amount limit exceeded
107Insufficient funds
108Authentication declined
109Technical issue
110Transaction expired
111Authentication timeout
112General error

Detailed References

Implementation Checklist

  1. Store client_id and client_secret securely (env vars)
  2. Implement token caching with expiry handling
  3. Use HTTPS for all callback URLs
  4. Implement idempotency keys for order creation
  5. Handle all response codes appropriately
  6. Log transaction IDs for debugging

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
19
Repository forks
4
7-day trend score
0

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/sepivip/claude-skill-bog-payment-gateway/bog-payment-gateway/badge)](https://verified-skill.com/skills/sepivip/claude-skill-bog-payment-gateway/bog-payment-gateway)

Something wrong with this skill or its page? Tell us.