भुगतान लेनदेन

MarkdownChatGPTClaude

शुरू करने से पहले

आपके API अनुरोध access token का उपयोग करके प्रमाणित किए जाते हैं। कोई भी अनुरोध जिसमें वैध access token शामिल नहीं है, त्रुटि लौटाएगा। अधिक जानें प्रमाणीकरण में।

Base URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Production: https://transactions.transactional.unico.app/api/public/v1

लेनदेन बनाएं

POST /credit/transaction — एक नया लेनदेन बनाता है।

खतरा

बेहतर कन्वर्ज़न सुनिश्चित करने के लिए, लेनदेन केवल किसी भी प्री-ऑथेंटिकेशन या वैलिडेशन को पूरा करने के बाद बनाएं, जो कार्ड नॉट प्रेजेंट सत्यापन अनुभव से पहले ऑपरेशन को समाप्त कर सकता हो।

खतरा

orderNumber फ़ील्ड को उस खरीद के e-commerce सिस्टम में यूनीक ऑर्डर नंबर से भरा जाना चाहिए — एक अलग ट्रांजैक्शनल ID का उपयोग करना गलत है। इसे दोबारा उपयोग करने से कम कन्वर्ज़न हो सकता है (ऑर्डर नंबर एंड यूज़र को फ्लो पूरा करने में मदद करता है) और यदि समान ऑर्डर नंबर, CPF, BIN, और अंतिम 4 अंकों का उपयोग किया जाता है तो replicated transaction जैसी API त्रुटियां हो सकती हैं।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

Body

{
  "identity": { "key": "cpf", "value": "12345678900" },
  "orderNumber": "order-98765",
  "company": "company-id",
  "redirectUrl": "https://yourapp.com/checkout/return",
  "card": {
    "binDigits": "12345678",
    "lastDigits": "1234",
    "expirationDate": "12/2028",
    "name": "John Doe"
  },
  "value": 199.90,
  "mainContacts": [
    { "key": "phone", "value": "5543999999999" }
  ],
  "additionalInfo": {
    "externalUserID": "YOUR_EXTERNAL_USER_ID"
  }
}

फ़ील्ड	प्रकार	आवश्यक	विवरण
identity	object	हां	उपयोगकर्ता पहचान डेटा।
identity.key	string	हां	उपयोगकर्ता पहचान की के प्रकार। cpf की सिफारिश की जाती है — उच्च कन्वर्ज़न रेट।
identity.value	string	हां	उपयोगकर्ता पहचान की का मान, बिना डॉट या डैश के।
orderNumber	string	हां	लेनदेन से जुड़ा ऑर्डर नंबर। पोर्टल में एक इंडेक्स के रूप में और आपके सिस्टम व कार्ड नॉट प्रेजेंट सत्यापन के बीच एक फॉरेन की के रूप में उपयोग किया जाता है।
company	string	हां	लेनदेन के लिए जिम्मेदार कंपनी की ID, जो Unico द्वारा प्रदान की जाती है।
redirectUrl	string	नहीं	लेनदेन पूरा होने के बाद उपयोगकर्ता को रीडायरेक्ट करने के लिए URL (वेब के लिए एक HTTPS URL, या नेटिव मोबाइल ऐप्स के लिए एक URL स्कीम)।
card	object	हां	लेनदेन में उपयोग किए गए कार्ड की जानकारी।
card.binDigits	string	हां	कार्ड के पहले 8 अंक।
card.lastDigits	string	हां	कार्ड के अंतिम 4 अंक।
card.expirationDate	string	नहीं	कार्ड की समाप्ति तिथि।
card.name	string	हां	कार्डधारक का नाम। इसे सही ढंग से भेजें, एन्कोडिंग समस्याओं से बचते हुए — इस डेटा का उपयोग उपयोगकर्ता अनुभव और संचार में किया जाता है।
value	number	हां	खरीद का कुल मूल्य।
mainContacts	array	नहीं	उपयोगकर्ता को सूचित करने के लिए उपयोग किए जाने वाले मुख्य संपर्कों (ईमेल और/या फ़ोन) की सूची, जब कार्ड नॉट प्रेजेंट सत्यापन सूचना के लिए जिम्मेदार होता है।
fallbackContacts	array	नहीं	फ़ॉलबैक संपर्कों की सूची, जो मुख्य संपर्कों की सूचना के प्रयास विफल होने पर ट्रिगर होती है।
additionalInfo	object	नहीं	इस लेनदेन के लिए साइलेंट सत्यापन सक्षम करने के लिए externalUserID के साथ यह ऑब्जेक्ट भेजें।
additionalInfo.externalUserID	string	हां (यदि additionalInfo भेजा गया हो)	डिवाइस मेटाडेटा एकत्र करते समय SDK के externalUserId के माध्यम से कॉन्फ़िगर किया गया वही आइडेंटिफायर। साइलेंट वैलिडेशन ट्रिगर करने के लिए आवश्यक — इसके बिना, लेनदेन सामान्य रूप से बनता है लेकिन हमेशा मानक विज़ुअल फ्लो का पालन करता है।

200 OK

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "processing",
  "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2026-07-22T15:30:00Z"
}

फ़ील्ड	विवरण
id	बनाए गए लेनदेन की ID।
status	लेनदेन की वर्तमान स्थिति।
link	लेनदेन से संबंधित लिंक।
token	कार्ड नॉट प्रेजेंट सत्यापन वेब SDK को इनिशियलाइज़ करने के लिए आवश्यक पैरामीटर वाला साइन किया गया token।
expiresAt	लेनदेन की समाप्ति तिथि और समय, ISO 8601 (UTC)।

चेतावनी

यदि वैलिडेशन यह निर्धारित करता है कि बायोमेट्रिक कैप्चर आवश्यक नहीं है, तो प्रतिक्रिया में एक भिन्न स्थिति होती है और कोई कैप्चर लिंक जनरेट नहीं होता:

{
    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
    "status": "fast-inconclusive"
}

ऐसा तब होता है जब Checkout के लिए Pre या Super Pre मॉड्यूल का उपयोग किया जाता है, Feature के अनुसार।

नोट

यदि additionalInfo.externalUserID भेजा गया था और लेनदेन साइलेंटली स्वीकृत हो गया है, तो प्रतिक्रिया में भी कैप्चर लिंक शामिल नहीं होता:

{
    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
    "status": "approved"
}

SDK सेटअप और टाइमिंग आवश्यकताओं सहित पूर्ण फ्लो के लिए साइलेंट सत्यापन देखें।

त्रुटि प्रतिक्रियाओं के लिए, देखें त्रुटियां — लेनदेन निर्माण।

लेनदेन स्थिति प्राप्त करें

GET /credit/transactions/{transaction_id} — किसी विशिष्ट लेनदेन की वर्तमान स्थिति जांचता है।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

200 OK

{
  "status": "processing"
}

फ़ील्ड	विवरण
status	लेनदेन की वर्तमान स्थिति।

सभी संभावित स्थितियों के लिए सूचीबद्ध मान देखें। परफॉर्मेंस को ऑप्टिमाइज़ करने के लिए, इस endpoint को पोल करने के बजाय Webhook लागू करें।

त्रुटि प्रतिक्रियाओं के लिए, देखें त्रुटियां — लेनदेन स्थिति प्राप्त करना।

लेनदेन साक्ष्य सेट प्राप्त करें

GET /credit/transactions/{transaction_id}/probative — किसी विशिष्ट लेनदेन का साक्ष्य सेट प्राप्त करता है।

चेतावनी

साक्ष्य सेट केवल स्वीकृत लेनदेन के लिए जनरेट किया जा सकता है।

खतरा

साक्ष्य सेट के लिए लौटाया गया लिंक प्राप्त होने के बाद पांच मिनट के लिए वैध होता है — इसे सहेजें नहीं, साक्ष्य सेट को तुरंत डाउनलोड करने के लिए इसका उपयोग करें।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

200 OK

{
  "link": "https://unico.io/probative.pdf"
}

फ़ील्ड	विवरण
link	प्रोबेटिव फ़ाइल का URL।

त्रुटि प्रतिक्रियाओं के लिए, देखें त्रुटियां — लेनदेन के साक्ष्य सेट की पुनर्प्राप्ति।

लेनदेन सूचना पुनः भेजें

POST /credit/transactions/{transaction_id}/notify — किसी विशिष्ट लेनदेन के लिए ईमेल और/या फ़ोन के माध्यम से सूचनाएं पुनः भेजता है।

नोट

API के माध्यम से इम्प्लीमेंट किए बिना, पोर्टल के माध्यम से भी सूचना पुनः भेजना कॉन्फ़िगर करना संभव है। संभावनाओं को समझने के लिए अपने प्रोजेक्ट के संपर्क बिंदु से बात करें।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

Body

{
  "phone": "NOTIFICATION_PHONE",
  "email": "NOTIFICATION_EMAIL"
}

फ़ील्ड	प्रकार	आवश्यक	विवरण
phone	string	हां	सूचना भेजने के लिए फ़ोन नंबर।
email	string	हां	सूचना भेजने के लिए ईमेल पता।

200 OK

{
  "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240",
  "link": "https://aces.so/example"
}

फ़ील्ड	विवरण
id	जनरेट की गई सूचना की यूनीक ID।
link	सूचना के लिए जनरेट किया गया लिंक।

त्रुटि प्रतिक्रियाओं के लिए, देखें त्रुटियां — लेनदेन सूचना पुनः भेजना।