Նկարագրություն
SDK roadmap-ը բացատրում է, թե որ VPOS.am libraries եւ examples-ը պետք է թողարկվեն API contract-ի եւ webhook lifecycle-ի կայունացումից հետո:
Ինչու SDK-ն պետք է հաջորդի API contract-ին
Եթե SDK-ն թողարկվի մինչ contract-ի կայունացումը, library-ն արագ դառնում է compatibility problem: Նախ պետք է ֆիքսվեն statuses, errors, webhook payload, idempotency եւ authorization rules:
Դրանից հետո thin helper libraries-ը կարող են արագացնել common tasks-ը՝ առանց payment lifecycle-ի կարեւոր details-ը թաքցնելու:
Որ examples-ն են առաջնային
Հայաստանի բիզնեսների համար ամենապրակտիկ start-ը backend examples-ն են՝ PHP/Laravel կայքերի եւ CRM-ի համար, Node.js webhook handlers-ի համար, Python/FastAPI internal APIs եւ integration services-ի համար:
Առանձին examples-ը օգտակար են WooCommerce, OpenCart եւ custom checkout-ի համար, բայց դրանք պետք է հիմնվեն նույն server-side contract-ի վրա:
Ինչպես պահել errors-ը transparent
SDK-ն չպետք է բոլոր խնդիրները դարձնի generic failed state: Integrator-ը պետք է տարբերի validation error, provider timeout, duplicate idempotency key, rejected payment եւ pending status:
Այս level of detail-ը օգնում է ճիշտ կառուցել retries, ցույց տալ օգտակար messages user-ին եւ չկոտրել CRM կամ ERP workflows-ը:
Հաճախակի հարցեր
Ինչու API contract-ը պետք է լինի SDK-ից առաջ:
SDK-ն պետք է հետեւի stable contract-ին: Եթե statuses, errors եւ webhook payloads-ը դեռ փոխվում են, library-ն դառնում է compatibility risk integrators-ի համար:
Որ SDK examples-ն են պետք առաջինը:
Առաջին հերթին պրակտիկ են PHP/Laravel websites եւ CRM-ի համար, Node.js webhook verification-ի համար եւ Python/FastAPI internal APIs-ի համար: CMS examples-ը պետք է օգտագործեն նույն server-side contract-ը: