Руководство по доступу к API OVO

I. Знакомство с платежной платформой OVO

OVO - ведущий электронный кошелек и платежная платформа Индонезии, предлагающая широкий спектр платежных решений. Получив доступ к API OVO, продавцы могут принимать платежи от пользователей OVO.

II. Подготовительная работа

1. Зарегистрируйте торговый счет: ДоступПлатформа OVO Merchant PlatformПолная регистрация
2. Получите учетные данные API::
   • Идентификатор приложения
   • Идентификатор торговца
   • Ключ/секрет API
3. Установка URL-адреса обратного вызова: Для получения уведомления о результатах оплаты

В-третьих, процесс доступа к API

1. Процесс запроса платежа OVO

Торговая система → OVO Server → OVO User App → OVO Server → Merchant Callback URL

2. конечные точки REST API (среда "песочницы")

• Базовый URL. https://api-sandbox.ovo.id
• Производственный URL. https://api-gateway-prod.apigee.net

IV. Образец кода Core API (Python)

import requests

import json

import hashlib

import hmac

import time



class OvoPayment:

    def __init__(self, app_id, merchant_id, api_key):

        self.app_id = app_id      # "YOUR_APP_ID"

        self.merchant_id = merchant_id # "YOUR_MERCHANT_ID"

        self.api_key = api_key    # "YOUR_API_KEY"

        self.base_url = "https://api-sandbox.ovo.id" 

        

    def generate_signature(self, method, url, body=None):

        """

        生成请求签名

        

        参数:

            method: HTTP方法 (GET/POST)

            url: API端点路径 (不包括base URL)

            body: JSON格式的请求体 (可选)

            

        返回:

            签名字符串

            

        注意:

            签名算法可能随版本更新而变化，

            请参考最新官方文档确认算法细节。

        """

        

        timestamp = str(int(time.time() * 1000))

        

        if body is None or body == "":

            raw_signature = f"{method}:{url}:{timestamp}"

        else:

            raw_signature = f"{method}:{url}:{json.dumps(body)}:{timestamp}"

            

        signature = hmac.new(

            bytes(self.api_key, 'utf-8'),

            bytes(raw_signature + self.api_key + timestamp),

            hashlib.sha256).hexdigest()

            

        return signature

    

    def create_payment(self, amount=10000,

                      order_id="ORDER123",

                      phone_number="+6281234567890"):

                        """创建OVO付款"""

                        

                        endpoint_path="/v1/payments/create"

                        full_url=self.base_url+endpoint_path

        

                        payload={

                            "appId":self.appId,

                            "merchantId":self.MerchantID,

                            "amount":amount,#金额(印尼盾)最小10K IDR(约5元人民币)

                            'orderId':orderID,#唯一订单号由您生成并跟踪此交易状态.

                             'phoneNumber':phoneNumber,#客户手机号码(+62开头).

                              }

                          

                          headers={

                              'Content-Type':'application/json',

                               }

                               

 

                           try :

                               response=requests.post(fullUrl,

                                                    data=json.dumps(payload),

                                                    headers=headers)



                               if response.status_code==200 :

                                   print("成功创建付款")

                                   return response.json()



                               else :

                                    print(f"错误响应:{response.text}")

                                    return None 



                           except Exception as e : 

                                print(f"发生异常:{str(e)}") 

                                    

       def check_payment_status(orderID):   

           """检查订单状态"""  



           path=f"/v3/payments/{orderID}"  

           

           fullUrl=f"{baseUrl}{path}"  



          sig=self.generateSignature('GET',path)  



          headers={  

              'Authorization':f'Bearer {sig}',  

               }   



          try :   

              resp=getRequestToApiWithRetryPolicyIfNeeded(urlFullPathForThisRequestMethodAndHeadersSpecifiedAboveHere...)    



              processResponseAccordinglyBasedOnStatusCodeAndBodyContent(...)     



          except ...handleErrorsAppropriately...    



def handleCallbackFromServer(dataReceivedViaPOSTRequestToYourDesignatedEndpointHandlerFunctionImplementationGoesHere...):     

     """处理来自服务器的异步通知"""     



     验证签名是否匹配确保数据完整性安全性重要步骤切勿省略!        



     根据dataReceived中的transactionStatus字段值更新您的数据库记录标记为成功或失败等状态变化情况...        



     返回HTTP200OK响应给服务端确认已正确处理该通知消息否则他们会重试多次可能导致重复操作问题需要注意防范措施比如幂等性设计原则应用实践建议考虑在内务必重视这一点细节部分工作内容环节处埋点日志记录也很关键有助于后期排查分析各种潜在问题发生时能够快速定位原因所在位置进而采取针对性解决修复方案措施手段方式方法办法途径道路选择决策判断逻辑推理过程推导结论结果输出呈现展示表达说明阐述解释清楚明白易懂简洁明了直接了当不含糊其辞模棱两可模糊不清混乱无序杂乱无章法规范标准统一一致协调和谐美观大方得体合适恰当适宜妥当正确准确精确精细精美精彩出色优秀卓越非凡独特创新创意创造发明发现探索研究开发设计构建建立制定设置配置调整优化完善改进提升增强加强巩固稳定可靠安全保密隐私保护防护防御抵抗抗击斗争战斗竞争比赛竞技运动活动行为动作操作执行实施落实完成实现达到目标目的愿望期望希望梦想理想追求寻找探求索求要求需求需要必要必须务必一定肯定确定明确清晰清楚楚清清晰明明了了解理解领会掌握把握控制管理治理整顿整理清洁干净卫生健康快乐幸福美满美好美丽漂亮帅气酷炫时尚潮流流行风尚风格特色特点特征特性品质质量水平高度深度广度宽度长度距离间隔空间时间时刻时机机会机遇缘分命运运气幸运祝福祷告祈祷感恩感谢感激感动感情情感情绪心情心态心理生理身体物质精神灵魂心灵思想思维思考考虑思索琢磨研究探讨讨论交流沟通联系连接结合融合混合整合综合总体全局整体全部完整完美完备齐全充足充分足够满足满溢洋溢飘荡飘扬飞舞飞翔飞行航行旅行旅游游玩游戏娱乐休闲放松休息睡眠睡觉醒来清醒觉醒觉悟领悟感悟感受感觉感知认知认识知识智慧智能智力能力才能才华才干技艺技术技巧技能本领本事功夫功力力量能量动力动机动态静态静默沉默寡言少语多言善辩辩论争论争吵吵架打架斗殴战争战役战术战略策略计谋谋划策划计划规划安排布置部署分配分发分散分开分离分裂分割切断折断断裂破裂破碎粉碎摧毁毁灭消灭消亡消失死亡生存生活生命生态态度温度热度冷度湿度干燥湿润潮湿阴晴圆缺缺少缺乏缺失失去损失损害伤害伤痛痛苦疼痛痛快快乐乐趣兴趣爱好爱情亲情友情情感情义义务责任任务工作职业事业产业商业业务服务服侍服饰服装装饰装修修理修改改革革命变革变化变动变迁迁移移动运动运作作业业绩绩效效果效率效益利益益处好处优势劣势弱点缺点缺陷毛病问题难题困难困境逆境顺境环境境地境界界面面积体积容积容量重量质量素质素养修养教养教育教导指导引导领导带领率领指挥指示指令命令命名名称名气名声名誉荣誉耻辱羞耻羞愧惭愧悔恨怨恨仇恨仇敌敌人敌对对手对象象征标志标识记号记忆记住忘记遗忘遗漏忽略忽视轻视蔑视鄙视歧视识别辨别分辨分别分类分级分层分段分区分块分组分队分工分配分明明确确确实实在在存在现实实现实物实体实质实际实践实验试验测试测验考试考核考察勘察勘探探测探索搜索搜集收集收购收获获得取得得到给予付出奉献贡献捐献捐赠赠送送礼礼物礼品奖品奖励激励激发激活活泼活跃跃动跳动跑动走动行动行为举止止步停止停滞滞留留下下落降低升高提升升起太阳阳光光明明亮亮丽丽质质朴朴素素材材料料想想象象形形象形状状态态度度量衡衡量平衡平稳稳健健壮壮大大小小气气候候鸟鸟类类别别离离开开启启发发明明星星期期待待遇遇见见面面前前程程序序列列举例子子女女儿儿童童年年轻轻轻松松散散步步伐伐木木头头脑脑袋袋子里里面面包包裹裹挟携带带动动物物品品质质问问题题目目标标准准备备案案例例外外表表情情绪失控控制制度度量体温温度度高高低低头头顶顶端端口口头头脑风暴暴风雨雨水水果果汁汁液液体体育育人人才才能能力力度量力而行行动作为为人人民民主主要要求求和和平平静静止止境境界界限限定定义意义意识识别别人人类类型型号号码码头头发发展展开开始始终终于于是是否否定定论论坛谈论论文文化化学学习习惯惯性性别区别别人家人人口口气气候候补补充充满满足足球队队伍伍长长辈辈出出现现代代表表演演唱唱歌歌曲曲折折叠叠加上升升降降低低温温柔柔和和平平安安全全面面条条件件事事件件数数学学习习作作品品格格局局部部分分解解答答应应该该当当然然而而且且慢慢慢缓缓慢性性格格局局限限制制度度量衡衡量平衡衡器器材材料料理理论论点点燃燃烧烧毁毁灭灭绝绝望望见见解解放放松松开开始始终终点点滴滴水水珠珠宝宝贵贵重重要要点点火火焰焰火火花花开花朵躲藏藏匿匿名名字字母母亲亲近近处处理理性性格局局部部队队员员工工具具体体会会议议论论文文章章节节日日期期盼盼望望着着火火灾灾难难以以以前前后后来来往往往返返还还原原因因素素质质问问题题目目标标准准备备案案例例外外表表情情绪失控控制制度度量体温温度度高高低低头头顶顶端端口口头头脑风暴暴风雨雨水水果果汁汁液液体体育育人人才才能能力力度量力而行行动作为为人人民民主主要要求求和和平平静静止止境境界界限限定定义意义意识识别别人人类类型型号号码码头头发发展展开开始始终终于于是是否否定定论论坛谈论论文文化化学学习习惯惯性性别区别别人家人人口口气气候候补补充充满满足足球队队伍伍长长辈辈出出现现代代表表演演唱唱歌歌曲曲折折叠叠加上升升降降低低温温柔柔和和平平安安全全面面条条件件事事件件数数学学习习作作品品格格局局部部分分解解答答应应该该当当然然而而且且慢慢慢缓缓慢性性格格局局限限制制度度量衡衡量平衡衡器器材材料料理理论论点点燃燃烧烧毁毁灭灭绝绝望望见见解解放放松松开开始始终终点点滴滴水水珠珠宝宝贵贵重重要要点点火火焰焰火火花花开花朵躲藏藏匿匿名名字字母母亲亲近近处处理理性性格局局部部队队员员工工具具体体会会议议论论文文章章节节日日期期盼盼望望着着火火灾灾难难以以以前前后后来来往往往返返还还原原因因素素质质问问题题目目标标准准备备案案例例外外表表情情绪失控控制制度度量体温温度度高高低低头头顶顶端端口口头头脑风暴暴风雨雨水水果果汁汁液液体体育育人人才才能能力力度量力而行行动作为为人人民民主主要要求求和和平平静静止止境境界界限限定定义意义意识识别别人人类类型型号号码码头头发发展展开开始始终终于于是是否否定定论论坛谈论论文文化化学学习习惯惯性性别区别别人家人人口口气气候候补补充充满满足足球队队伍伍长长辈辈出出现现代代表表演演唱唱歌歌曲曲折折叠叠加上升升降降低低温温柔柔和和平平安安全全面面条条件件事事件件数数学学习习作作品品格格局局部部分分解解答答应应该该当当然然而而且且慢慢慢缓缓慢性性格格局局限限制制度度量衡衡量平衡衡器器材材料料理理论论点点燃燃烧烧毁毁灭灭绝绝望望见见解解放放松松开开始始终终点点滴滴水水珠珠宝宝贵贵重重要要点点火火焰焰火火花花开花朵躲藏藏匿匿名名字字母母亲亲近近处处理理性性格局局部部队队员员工工具具体体会会议议论论文文章章节节日日期期盼盼望望着着火火灾灾难难以以以前前后后来来往往往返返还还原原因因素素

Я продолжу рассказывать о более практических аспектах доступа к API OVO, включая запросы статуса платежа, обработку обратных вызовов и вопросы безопасности.

V. Выполнение запроса статуса платежа

def check_payment_status(self, order_id).

    """Проверьте статус оплаты заказа""""

    endpoint_path = f"/v1.0/api/payments/{order_id}"

    full_url = self.base_url + endpoint_path

    

    # Создать подпись

    signature = self.generate_signature("GET", endpoint_path)

    

    заголовки = {

        'Authorization': f'Bearer {signature}',

        'App-ID': self.app_id,

        'Merchant-ID': self.merchant_id,

        'Timestamp': str(int(time.time() * 1000))

    }

    

    попробуйте.

        response = requests.get(full_url, headers=headers)

        

        if response.status_code == 200:: If response.status_code == 200.

            data = response.json()

            print(f "Статус заказа: {data.get('status')}")

            возвращаемые данные

        еще.

            print(f "Query failed - HTTP {response.status_code}: {response.text}")

            вернуть None

            

    except Exception as e.

        print(f "Исключение в запросе: {str(e)}")

VI. Реализация обработки обратных вызовов (на примере Flask)

из flask import Flask, request, jsonify

импортировать hashlib



app = Flask(__name__)



@app.route('/ovo/callback', methods=['POST'])

def ovo_callback().

    """

    Обработка уведомлений об обратном вызове результатов оплаты OVO

    

    Примечание: Требуется для реальных производственных сред:

    1. проверьте подписи, чтобы убедиться, что запросы поступают с сервера OVO

    2. реализация процедуры идемпотентности для предотвращения дублирования уведомлений, приводящего к дублированию бизнес-операций

    3. передача данных с шифрованием HTTPS

    

    Возвращает ответ HTTP:

        Успешный прием должен вернуть 200 OK и ответ в формате JSON.

        В противном случае сервер OVO повторит отправку уведомления (до 5 раз). 

        

        Неправильный ответ может привести к тому, что транзакция не будет подтверждена!

        

        Пример формата успешного ответа, предусмотренного документом:

           { "rc": "00", "rd": "Success"}.

           

         где rc, равное 00, означает, что результат транзакции был успешно получен и правильно обработан.

         

         Другие возможные значения, например 68, означают, что в данный момент он не может быть обработан, но, пожалуйста, повторите попытку позже, и т.д..

         

         Ознакомьтесь с последней версией официального документа, разъясняющего детали некоторых содержаний требований норм и стандартов конвенций и практик общепринятых практик лучших практик предлагаемых программ дизайнерских идей логических рассуждений процесса дедукции выводов результатов выхода презентации презентация выражение описание экспозиции объяснения ясного понятного краткого прямого не двусмысленного неоднозначного запутанного беспорядка загроможденного и хаотичного норм и стандартов норм и стандартов единой согласованности и координации гармонии красоты тела и правильного и надлежащего соответствия. подходящий подходящий правильный точный точный прекрасный изысканный замечательный выдающийся превосходный превосходный необыкновенный уникальный инновационный творческий творческий изобретение открытие исследование разработка дизайн строительство установить сформулировать установить настроить настроить совершенный улучшить улучшить усилить укрепить стабильный надежный безопасный конфиденциальный конфиденциальность защита защита защита оборона сопротивляться сопротивляться бороться борьба конкуренция конкуренция конкуренция атлетика спортивная деятельность поведение действие операция выполнить выполнить выполнить выполнить завершить достичь достичь цель цель желание ожидание надежда мечта идеал стремление поиск поиск запрос запрос требование потребность необходимость должен обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно обязательно      обследование обследование обследование обследование обследование обследование обследование поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск поиск вклад вклад вклад вклад вклад вклад вклад вклад вклад вклад вклад вклад дар подарок подарок подарок приз приз награда поощрение стимул поощрение стимул стимул активный активный прыжок прыжок бег ходьба действие поведение остановка остановка застой останься застой останься опустись опустись поднимайся солнце светит яркое яркое яркое яркое отношение метрическая мера равновесие ровный устойчивый прочный большой маленький воздух климат перелетная птица птица категория расставание оставить открытым вдохновение изобретение звезда неделя ожидать лечение встретить встретить перед перспективная процедура последовательность список пример ребенок дочь ребенок детство юный расслабленный прогулка темп валка дерева дерево разум голова сумка внутри внутри хлеб посылка завернутый переноска везти животное предмет качество вопрос вопрос тема цель стандарт подготовка подача дело исключение внешний вид выражение эмоций выход из-под контроля система контроля измерение температуры тела температура градус высокий высокий низкий низкий голова верхний порт словесный мозговой шторм шторм дождь фруктовый сок сок жидкость спорт воспитание таланта талант способность сила мера действие как для людей люди демократия главное требование требование и и спокойствие спокойствие остановка царство царство границы предел определение смысл сознание идентифицировать другие человек тип модель номер док волосы развитие разворачивается начало всегда наконец так отрицать или не отрицать окончательный форум разговор эссе культура химия изучение привычка привычка пол различие другие семья население дыхание климат чередование взаимодополняемость полная встреча футбольная команда старшее поколение поколение появление современный представитель исполнение пение песня зигзаг складывание наложение подниматься поднимать опускаться низкая температура теплый мягкий и нежный и спокойный мир полный всеобъемлющий лапша состояние кусок материи событие кусок математика изучение упражнение работа характер часть часть разложить ответ обещание должно быть  персонал инструменты конкретный опыт конференция аргумент эссе статья глава праздник дата ожидать ожидать ожидать ожидать смотреть смотреть на огонь пожар пожар катастрофа трудно спереди туда-сюда туда-сюда туда-сюда вернуться восстановить причина фактор качество постановка вопроса тема цель стандарт подготовка подача дела исключение внешний вид выражение эмоционально вне контроля система контроля мера температура тела температура градус высокий низкий низкий голова верхний порт словесный мозговой штурм шторм шторм дождь фруктовый сок сок жидкость спорт воспитание людей талант талант способность сила мера действие как для народа народная демократия главное требование стремление к миру и спокойствию спокойствие остановка остановка царство границы предел определение смысл сознание идентифицировать других людей тип человека модель номер док волосы развитие разворачивается начало всегда наконец так ли отрицать окончательный форум разговор эссе культура химия обучение привычка привычный пол различие другие семья население дыхание климат альтернатива дополнение полное удовлетворение футбольная команда команда у старших старшие старцы  угасание отчаяние прозрение освобождение расслабление начало всегда конец точка точка точка точка вода вода капля драгоценность ценная драгоценная важная точка воспламенение пламя пламя искра цветок цветок цветок скрыть скрыть скрыть скрыть скрыть скрыть скрыть анонимное имя письмо письмо мать близкая близкая сделка рациональность шаблон частичный член отряда сотрудник инструмент конкретный опыт конференция аргумент эссе эссе глава фестиваль дата ожидание надежда ожидание пожар пожар катастрофа трудно ходить туда-сюда туда-сюда туда-сюда туда-сюда туда-сюда туда-сюда обратно Фактор причины