快速搭建PayPal标准API测试框架

根据PayPal官方Postman指引页快速搭建标准API测试框架https://developer.paypal.com/api/rest/postman/一、第一步官网一键导入PayPal官方完整REST接口集合核心浏览器打开官方指引页面https://developer.paypal.com/api/rest/postman/页面分为两个导入按钮Import Sandbox Collection沙盒测试环境虚拟订单测试用Import Live Collection正式生产环境GRW商户真实业务你当前使用→点击这个点击Import Live Collection→弹窗选择【Open in Postman】自动跳转Postman客户端/网页端一键导入PayPal全套V2 REST接口包含订单、捕获、退款、对账等全接口不用手动新建接口URL。✅ 导入自动生成两样东西① CollectionPayPal REST API LivePayPal官方封装完整接口② EnvironmentPayPal Live Environment官方预定义环境变量baseUrl、clientId、clientSecret二、第二步填入GRW商户正式API密钥配置环境登录PayPal开发者后台developer.paypal.comGRW Trading FZE主管理员账号→Apps Credentials→Live→打开已创建的Live应用复制Client IDClient SecretPostman左侧【Environments】→打开PayPal Live Environment变量填写内容备注baseUrlhttps://api.paypal.com官方已经预填好无需修改clientId粘贴Live ClientID正式商户密钥clientSecret粘贴Live Client Secret正式商户密钥保存环境右上角选中PayPal Live Environment。三、第三步使用官方自带Token获取接口废弃你之前手动写的01_GetToken导入的官方集合内自带目录Authentication→Generate OAuth2 Access Token该接口是PayPal官方写好的获取Bearer Token请求AuthorizationBasic Auth自动引用环境{{clientId}}/{{clientSecret}}Body自带grant_typeclient_credentialsTests内置自动脚本请求成功后自动把access_token存入环境变量后续全接口直接{{access_token}}鉴权。不再需要手动编写获取Token的请求官方原生适配PayPal鉴权规则。配套优化解决【每轮Run重复请求Token】打开Generate OAuth2 Access Token→ Pre-request Script粘贴跳过脚本//非第一轮循环直接跳过Token请求letindexNumber(pm.environment.get(loopIndex));if(index0){pm.execution.skipRequest();console.log(非首轮跳过OAuth获取);}四、第四步在官方框架内新增你的批量查询接口适配多CaptureID批量查询在PayPal REST API Live集合里新建自定义文件夹Batch_Capture_Query新增2个GET请求请求1Query_Capture_Detail查扣款URL{{baseUrl}}/v2/payments/captures/{{currentCaptureId}}AuthorizationBearer Token →{{access_token}}Pre-request Script从数组取当前IDletarrJSON.parse(pm.environment.get(captureList));letidxNumber(pm.environment.get(loopIndex));pm.environment.set(currentCaptureId,arr[idx]);Tests提取OrderID下标自增letrespm.response.json();letoidres.supplementary_data.related_ids.order_id;pm.environment.set(orderId,oid);letnewIdxNumber(pm.environment.get(loopIndex))1;pm.environment.set(loopIndex,newIdx);请求2Query_Order_FullData查全量订单买家/地址/商品/税费URL{{baseUrl}}/v2/checkout/orders/{{orderId}}AuthorizationBearer Token →{{access_token}}Tests提取需要的业务字段用于批量导出letorderDatapm.response.json();//买家信息letbuyerName${orderData.payer.name?.given_name||}${orderData.payer.name?.surname||};letbuyerEmailorderData.payer.email_address;//收货地址、税费、支付来源letshipAddressorderData.purchase_units[0].shipping?.address||{};lettaxValueorderData.purchase_units[0].amount.breakdown?.tax?.value||0;letpaySourceorderData.payment_source?Object.keys(orderData.payment_source)[0]:PayPal余额;//存入全局变量批量导出CSVpm.globals.set(buyerName,buyerName);pm.globals.set(buyerMail,buyerEmail);pm.globals.set(tax,taxValue);pm.globals.set(paySource,paySource);五、第五步补充批量环境变量集合全局初始化打开PayPal Live Environment环境追加4个变量|变量名|初始值||----|----||captureList|[2M331120UK046314S,1PJ581750B801442J]||loopIndex|0||currentCaptureId|空||orderId|空|双击顶层集合PayPal REST API Live→Pre-request Script集合全局脚本//整批批量仅启动时初始化1次下标全生命周期只执行一次pm.environment.set(loopIndex,0);点击Update保存。六、第六步批量一键Run运行集合右侧▶Run打开RunnerEnvironmentPayPal Live EnvironmentIterations迭代数2数组内2个CaptureID执行顺序从上至下① Generate OAuth2 Access Token② Query_Capture_Detail③ Query_Order_FullDataStart run运行逻辑第一轮获取Token→取数组下标0第一个ID查单→下标1第二轮跳过Token请求→取下标1第二个ID查单→下标2两条不同订单数据不再重复。七、沙盒环境快速切换方法如需测试虚拟订单回到官网页面点击Import Sandbox Collection导入沙盒专用集合baseUrl自动变为https://api-m.sandbox.paypal.com填入沙盒ClientID/Secret即可。框架优势官方原生接口所有URL、字段跟随PayPal官方版本更新避免手写接口地址出错统一环境变量baseUrl切换沙盒/正式只需要换环境不用逐个改接口域名鉴权标准化官方OAuth逻辑杜绝401/域名密钥不匹配报错。