OVO APIアクセスガイド

I. OVOペイメント・プラットフォームの紹介

OVOはインドネシアの主要な電子財布および決済プラットフォームで、幅広い決済ソリューションを提供しています。OVO APIにアクセスすることで、加盟店はOVOユーザーからの支払いを受け入れることができます。

II.準備作業

1. マーチャントアカウントの登録アクセスOVOマーチャント・プラットフォーム登録完了
2. API認証情報の取得::
   • アプリID
   • マーチャントID
   • APIキー/シークレット
3. コールバックURLの設定支払結果通知を受け取る

第三に、APIアクセス・プロセス

1.OVO支払い請求プロセス

マーチャントシステム → OVOサーバー → OVOユーザーアプリ → OVOサーバー → マーチャントコールバックURL

2. REST APIエンドポイント（サンドボックス環境）

• ベースURL。 https://api-sandbox.ovo.id
• 制作URL。 https://api-gateway-prod.apigee.net

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

引き続き、支払いステータスクエリ、コールバック処理、セキュリティの考慮点など、OVO APIアクセスのより実践的な側面について詳しく説明する。

V. 支払い状況照会の実施

def check_payment_status(self, order_id).

    """注文の支払い状況を確認する""""

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

    full_url = self.base_url + endpoint_path

    

    # 署名の生成

    署名 = self.generate_signature("GET", endpoint_path)

    

    ヘッダー = {

        'Authorization': f'ベアラ{署名}'、

        'App-ID': self.app_id、

        'Merchant-ID': self.merchant_id、

        'タイムスタンプ': 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 "クエリに失敗しました - HTTP {response.status_code}: {response.text}")

            なし

            

    例外を除く。

        print(f "リクエスト例外：{str(e)}")

VI.コールバック処理の実装（Flaskの例）

from 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"："成功"}。

           

         ここで、rcの00は、トランザクション結果が正常に受信され、正しく処理されたことを示す。

         

         68のような他の可能な値は、今は処理できないが後でもう一度試してください、などを意味する。

         

         公式文書の最新版を参照し、規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。規範と基準の要求事項の一部の内容の詳細を説明する。適切な 適当な 正確な 正確な 精巧な 絶妙な 素晴らしい 優れた 優れた ユニークな 革新的な 創造的な 発明 発見 探求 研究 開発 設計 構築 構築 構築する 設定する 調整する 完璧な 改善する 強化する 統合する 安定する 信頼できる 安全な 機密 保護する 防御する 抵抗する 戦う 競争 競技 スポーツ活動 行動する 実行する 実施する 完成する 達成する 目標 目的 願望期待 希望 夢 理想 追求 探求 探求 要求 要求 必要 必要 必要 必ず 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実 確実ビジネス ビジネス サービス サービス 服装 装飾 修繕 改革 革命 変化 変化 移転 移動 動作 動作 パフォーマンス パフォーマンス 効果 効率 効率 メリット メリット メリット デメリット デメリット 欠陥 欠陥 問題 困難 ジレンマ 逆境 円滑 環境 状況 界面 面積 体積 容積 重さ 品質 品質 栽培 育成 教育 指導 指導 リーダーシップ 指揮 命令 指示態度 メートル メジャー バランス スムーズ 安定 堅牢 大きい 堅牢 小さい 空気 気候 渡り鳥 鳥 カテゴリー 別れる 置き去り ひらめき 発明 星 週 予想 治療 会う 目の前 見込み 手続き シーケンス リスト 例 子供 娘 子ども 幼い ゆったり 歩く ペース 伐採 木 心 頭 頭袋 内側 パン 小包 包む キャリー キャリー ドライブ 動物 アイテム 品質 質問 テーマ 目標 標準 準備 ファイリング ケース 例外外見 表情 感情 制御不能 制御システム 測定 体温 温度 度 高さ 低さ 頭部 頭頂部 ポート 言語 ブレーンストーム 嵐 雨 果汁 ジュース 液体 スポーツ 育成 才能 能力 強さ 測定 行動 人々にとって 民主主義 主な 要件 and calm 落ち着き 止まり 領域 境界 限界 定義 意味 意識 特定 他人 人間のタイプ 型番 ドック 髪の毛 発達 展開 開始 常に 最終的 そう否定するかどうか 決定的なフォーラム トーク エッセイ 文化 化学 学習 習慣 習慣的 性別 他人 家族 人口 呼吸 気候 交互 補完 フル ミート サッカー チーム 年長者 世代 創造 現代 代表 パフォーマンス 歌唱 歌曲 ジグザグ 折り畳み 重ね合わせ 上昇 持ち上げ 下降 低温 暖かく 柔らかく 穏やか 平和 全包括的な 麺の状態 物質のかけら 出来事 数学のかけら 学習 演習 作品 性格 パターン 部分 部分 分解 答え 約束 するべきである才能 才能 能力 強さ 測定 行動 人々のために 人民民主主義 主な要件 平和を求める 冷静さ 停止 領域 境界 限界 定義 意味 意識 特定 他人 人間のタイプ 型番 ドック 髪の毛 発達 展開 開始 常に 最終的に そう 否定するかどうか 決定的な フォーラム トーク 論文 文化 化学 学習 習慣 性別 他人 家族 人口 呼吸 気候 代替 サプリメント フル コンテンツ サッカー チーム ウー 年長者 年長者generation emerges emerges modern representative performance singing singing song zigzag fold folding superimposed rising rising rising lowering lowering low temperature gentle gentle and peaceful comprehensive noodle condition piece of matter event piece of maths learning study exercise work character pattern partial partial decomposition answer promise ought to ought to course of course however however and slowly slowly slowly chronic character pattern limitation limitation limitation system metric measure measure balance weighing weighing equipment material material cooking theory theory ignition burning burning destruction destroying.絶滅 絶望 見る 洞察 解放 緩める 始める いつも 終わる 点点 点点 水 水滴 宝石 貴重 貴重 重要 点点 点火 炎 火花 花 花 隠す 隠す 匿名 名前 手紙 手紙 母 親しい 取引 合理性 パターン 部分的 部隊員 従業員 道具 具体的 経験 会議 論作文 エッセイ エッセイ章句 祭日 期待 希望 楽しみ 見ること 火災 火災災害 困難 前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後前後理由 因子