带有服务器集成的 PayPal 客户端 JavaScript SDK - 设置付款金额
Posted
技术标签:
【中文标题】带有服务器集成的 PayPal 客户端 JavaScript SDK - 设置付款金额【英文标题】：PayPal client side JavaScript SDK with server integration - Set payment amount 【发布时间】：2021-03-22 11:24:26 【问题描述】：我正在尝试将客户端 PayPal javascript SDK 与 PayPal 服务器端 REST API 集成。 我知道如何在客户端 JavaScript SDK 和服务器端 REST API 中创建新的 PayPal 订单。我都成功地做到了。但问题是，无论我采用哪种方式，都会出现问题。如果我在服务器上创建了一个新订单，而不是在客户端代码中，那么客户登录后显示的价格是 0.01 美分，而不是正确的价格，即使订单创建正确。
我可以同时使用客户端 createOrder 方法和服务器端订单创建，但我担心它会创建两个订单，甚至可能捕获两个付款。
我找不到集成服务器端订单创建和在用户登录后出现的 PayPal 对话框中设置价格的方法。
不使用客户端createOrder方法，如何在用户登录后显示产品价格？
如果我在服务器上创建订单并将订单 ID 传递回客户端代码，则客户端 JavaScript API 会出现 3 个关于 PATCH 的错误。我不明白。
我可以省略客户端 createOrder 方法，除了付款金额默认为 0.01 美分外，一切正常。我不想那样。
客户端代码：
function thePromiseCode()
return new Promise (function (resolve,reject)
google.script.run
.withSuccessHandler (function (result)
resolve (result);//What resolve does is return the result from the server back to the FIRST anonymous function in the "then" part
)
.withFailureHandler (function (error)
reject (error);
)
.createA_PayPalOrder();//Call the server to create a PayPal order
)
function initPayPalButton()
thePromiseCode()// Call the server code to create an order
.then(
function(response)
console.log('response 89: ' + response)
var orderObj = JSON.parse(response);
window.payPalOrderId = orderObj.id;
console.log('payPalOrderId: ' + payPalOrderId)
,
function (error)
showModalMessageBox("There was an error in the PayPal button!","ERROR!");
console.log(error);
return "Error";
);
paypal.Buttons(
style:
shape: 'rect',
color: 'gold',
layout: 'vertical',
label: 'paypal',
,
createOrder: function(data, actions)
// This fnc sets up the details of the transaction, including the amount
return actions.order.create(
purchase_units:[
"description":"My Product Name",
"amount":
"currency_code":"USD",
"value":"2.95",
]
);
,
onApprove: function(data, actions)
return actions.order.capture().then(function(details)
payPalPaymentComplete();
console.log('Transaction completed by ' + details.payer.name.given_name + '!');
);
,
onCancel: function (data, actions)
// Show a cancel page or return to cart
showModalMessageBox('PayPal Session was cancelled',"CANCELLED!");
backToStartPay();
,
onError: function(err)
showModalMessageBox("There was an error in the PayPal button!","ERROR!");
console.log(err);
).render('#paypal-button-container');
initPayPalButton();
</script>
【问题讨论】：
【参考方案1】：如果我在服务器上创建订单并将订单 ID 传递回客户端代码，则客户端 JavaScript API 会出现 3 个关于 PATCH 的错误。我不明白。
您需要提供有关此问题的更多详细信息，因为这似乎是您需要帮助的地方。
此示例中显示了调用服务器的正确方法：https://developer.paypal.com/demo/checkout/#/pattern/server
必须完全避免使用actions.order.create() 和.capture()。
【讨论】：
很好，你已经让它工作了，但同样，对于服务器集成，你不应该调用 .create() 和 .capture()。如果您这样做，那么您做错了事并为您的支付系统造成了可靠性问题。上面链接了正确的集成，通过直接 API 调用以及通过 API 传递的所有适当参数进行创建/捕获。 仅供参考 createOrderfetch 可以采用 body 参数将数据传输到您的服务器，如果您不清楚的话。您的服务器可以在将所有数据发送到 PayPal 以通过 API 创建订单之前验证所有数据，这是服务器端集成的优势之一（另一个更重要的是在服务器端进行相应的捕获，从而拥有即时服务器- 成功/失败的通知）
哦...好吧，您显然需要createOrder 和onApprove。我只提到了actions... 作为要避免的具体事情。那就继续吧。【参考方案2】：
这是我使用客户端 PayPal Javascript SDK 和服务器端 PayPal API 接受买家付款的解决方案。 这个服务器代码是特定于 Apps Script 的，来自客户端的服务器调用也是特定于 Apps Script 的。
注意：要“直播”，您必须：
从 url 中删除单词 sandbox - 见：https://developer.paypal.com/docs/paypal-plus/germany/integrate/test-and-go-live/#go-live 使用不同的客户端和秘密凭据服务器代码 - 应用程序脚本
function payPalSettings_()
//see:
//https://developer.paypal.com/docs/business/javascript-sdk/javascript-sdk-reference/#createorder
return
intent:'CAPTURE',//The PayPal JavaScript SDK defaults to capture if not set
//but for purposes of explicitly making it clear what the code is doing -
//it is being set here -
//The Capture setting results in the capturing of funds immediately
//after the buyer approves the purchase -
purchase_units:[
"custom_id":"abc123",//You can add a custom value to pass to PayPal
"description":"Emails Director Gold",
"amount":
"currency_code":"USD",
"value":"2.95",
],
function getCredentials_()
var CLIENT_Live,Paypal_Client_Test,PayPalSecret_Test,rtrnObj,SECRET_Live;
rtrnObj = ;
Paypal_Client_Test = 'abc123';//You must get this from your PayPal account
PayPalSecret_Test = '321cba';
//For testing comment out the live credentials
//CLIENT_Live = 'put it here';//You must get this from your PayPal account
//SECRET_Live = 'put it here';
rtrnObj.client = CLIENT_Live ? CLIENT_Live : Paypal_Client_Test;//If the live credential is available then use it
rtrnObj.secret = SECRET_Live ? SECRET_Live : PayPalSecret_Test;
return rtrnObj;
/* This code is for making calls to PayPal from the SERVER
This server code must work together with the client side code
*/
//To see the equivalent of this code go to:
//https://developer.paypal.com/docs/business/checkout/server-side-api-calls/create-order#1-add-server-code
//which is the Add Server Code section and show the JavaScript code
function captureThePayment(po)
try
var accessTkn,capture,options,PayPal_Capture_API,rCode;
/*
po.orderId - the order ID
*/
/*
See documentation at:
https://developer.paypal.com/docs/checkout/reference/server-integration/capture-transaction/
*/
//Logger.log('po 61',po)
accessTkn = getAuthTkn_();
PayPal_Capture_API = 'https://api.sandbox.paypal.com/v2/checkout/orders/' + po.orderId + '/capture';
//Logger.log('PayPal_Capture_API',PayPal_Capture_API)
options = ;
options.muteHttpExceptions = true;
options.method = 'post';
options.headers =
//"Accept":"application/json",
"Authorization": "Bearer " + accessTkn
options.contentType = 'application/json';//This needs to be used or it doesnt work
capture = UrlFetchApp.fetch(PayPal_Capture_API,options);//Call PayPal to capture the order
//Logger.log('capture.getResponseCode() 77',capture.getResponseCode())
//Logger.log('capture 85',capture)
//Logger.log('capture.error',capture.error)
rCode = capture.getResponseCode();
if (rCode !== 200 && rCode !== 201)
//Logger.log('capture.getContentText',capture.getContentText)
throw new Error("Error capturing the payment: " + rCode);
//Logger.log('capture.getContentText',capture.getContentText)
/*
There is no response - just a response code
To get order detail another request must be made to PayPal
*/
// Do your own custom processing
return true;//The capture option doesnt return anything but a response code - it doesnt return order details -
//to get order details you would need to use the base API url with just the order number on the end-
//See https://developer.paypal.com/docs/checkout/reference/server-integration/get-transaction/
catch(e)
//Logger.log('message',e.message)
//Logger.log('stack',e.stack)
function createA_PayPalOrder()
try
var authTkn,options,order,paySets,payload,response;
authTkn = getAuthTkn_();
//2 Set up your server to receive a call from the client
PAYPAL_ORDER_API = 'https://api.sandbox.paypal.com/v2/checkout/orders/';//Must be changed for live mode
// 3 Call PayPal to set up a transaction
options = ;
paySets = payPalSettings_();
//console.log('paySets 121' + paySets)
options.muteHttpExceptions = true;//
options.method = 'post';
options.headers =
"Accept":"application/json",
"Authorization": "Bearer " + authTkn
options.contentType = 'application/json';
options.payload = JSON.stringify(paySets);
response = UrlFetchApp.fetch(PAYPAL_ORDER_API,options);//Call PayPal to set up a transaction
//console.log('response.getResponseCode() 131' + response.getResponseCode())
/*
The response returned should look like:
"id":"abc123",
"status":"CREATED",
"links":["href":"https://api.sandbox.paypal.com/v2/checkout/orders/abc123",
"rel":"self",
"method":"GET",
"href":"https://www.sandbox.paypal.com/checkoutnow?token=abc123",
"rel":"approve",
"method":"GET",
"href":"https://api.sandbox.paypal.com/v2/checkout/orders/abc123",
"rel":"update","method":"PATCH",
"href":"https://api.sandbox.paypal.com/v2/checkout/orders/abc123/capture",
"rel":"capture",
"method":"POST"]
*/
//4 Handle any errors from the call
if (response.getResponseCode() !== 201)
//console.log('response.getContentText() 135' + response.getContentText())
//console.log(response);
return "error";
order = response.getContentText();
//order = JSON.parse(order);
//console.log('order.id 166' + order.id)
//5 Return a successful response to the client
return order;
catch(e)
//console.log('message' + e.message)
//console.log('stack' + e.stack)
function getAuthTkn_()
try
var auth,basicAuth,cacheService,creds,credentialClient,credentialSecret,keyConcat,options,payPalToken,PAYPAL_OAUTH_API,paySets,
payload,response,tkn;
/*Log into your developer dashboard: https://www.paypal.com/signin?returnUri=https%3A%2F%2Fdeveloper.paypal.com%2Fdeveloper%2Fapplications
Note that the sandbox (for testing) and the live modes both have their own apps - So I would create different app names for
each one -
If you have not created an app then create an app
If you need to create an app then you will need to generate the credentials
If you already have an app and credentials then you can use those
When getting your credentials the first thing you must do is choose either sandbox or live -
*/
cacheService = CacheService.getDocumentCache();
try
payPalToken = cacheService.get("authTkn");
catch(e)
if (payPalToken) //There is already a PayPal auth token generated and in Cache
return payPalToken;
creds = getCredentials_();
credentialClient = creds.client;
credentialSecret = creds.secret;
PAYPAL_OAUTH_API = 'https://api.sandbox.paypal.com/v1/oauth2/token/';//1B Use the PayPal APIs which are called with the following URLs -
keyConcat = credentialClient + ':' + credentialSecret;//concatenate the client and secret credentials
basicAuth = Utilities.base64Encode(keyConcat);//Base 64 encode
options = ;
payload = ;
payload.grant_type = "client_credentials";
options.muteHttpExceptions = true;//
options.method = 'post';
options.headers =
"Accept":"application/json",
"Authorization": "Basic " + basicAuth
options.payload = payload;
response = UrlFetchApp.fetch(PAYPAL_OAUTH_API, options);//1C Get an access token from the PayPal API
//Logger.log('response.getResponseCode() 80',response.getResponseCode())
auth = response.getContentText();
//Logger.log('auth 83',auth)
/*
The response returned should look like this:
"scope":"https://uri.paypal.com/services/invoicing
https://uri.paypal.com/services/disputes/read-buyer
https://uri.paypal.com/services/payments/realtimepayment
https://uri.paypal.com/services/disputes/update-seller
https://uri.paypal.com/services/payments/payment/authcapture openid
https://uri.paypal.com/services/disputes/read-seller
https://uri.paypal.com/services/payments/refund
https://api.paypal.com/v1/vault/credit-card https://api.paypal.com/v1/payments/.*
https://uri.paypal.com/payments/payouts https://api.paypal.com/v1/vault/credit-card/.*
https://uri.paypal.com/services/subscriptions
https://uri.paypal.com/services/applications/webhooks",
"access_token":"abc123",
"token_type":"Bearer",
"app_id":"APP-abc123",
"expires_in":32400,
"nonce":"2020-12-09T01:07:abc123"
*/
if (!auth)
throw new Error("Authorization information not retrieved from PayPal");
auth = JSON.parse(auth);
//Logger.log('auth',auth)
//Logger.log('auth.access_token 90',auth.access_token)
tkn = auth.access_token;
cacheService.put("authTkn", tkn, 180);//Save in cache for 3 minutes
return tkn;
catch(e)
Logger.log('message',e.message)
Logger.log('stack',e.stack)
console.log(e)
客户端 html
<!-- This code uses the client side JavaScript PayPal SDK -->
<div style="text-align: center;">
<div id="paypal-button-container"></div>
</div>
客户端 JavaScript
<!--
Required files:
This code works together with the server code -
This PayPal payment system uses both the PayPal javascript SDK AND server side PayPal API calls -
This PayPal payment system uses Smart Payment Buttons - See: https://developer.paypal.com/docs/checkout/
The two most important documentation links are:
https://developer.paypal.com/docs/checkout/integrate/
https://developer.paypal.com/docs/checkout/reference/server-integration/set-up-transaction/
For configuration settings there is information at:
https://developer.paypal.com/docs/business/javascript-sdk/javascript-sdk-reference/
Note that this PayPal implementation does NOT require there to be a button definition in your PayPal settings -
The PayPal JavaScript client side SDK is newer than the checkout.js
See this Link: https://developer.paypal.com/docs/archive/checkout/how-to/server-integration/
For an overview of the PayPal checkout with server integration -
It is very important to understand the "sandbox" and the "production" settings -
There are mutliple settings that must all be for either "sandbox" or "production"
If you mix "sandbox" and "production" credentials and API links then your code will not work
and the error messages may not help you to understand what the real problem is -
Anything to do with "sandbox" is for testing purposes -
"production" is for accepting live payments from customers -
The terminology that PayPal uses for the credentials is:
client id - The client side credential key
secret - The server side credential key
Credentials need to be in three different settings-
1 - Client side script tag - client id
2 - Server side variable - client id
3 - Server side variable - secret
To test your PayPal code you must do multiple things:
1 - Create sandbox (test) client and secret credentials
2 - use a special buyer PayPal account:
https://developer.paypal.com/docs/checkout/integrate/
-->
<script src="https://www.paypal.com/sdk/js?client-id= YOUR CLIENT ID HERE - MAKE SURE IT MATCHES EITHER SANDBOX OR PRODUCTION ¤cy=USD"></script>
<script>
window.payPalPaymentComplete = function(orderId)
showModalMessageBox("Payment is complete","COMPLETE!");
window.backToStartPay = function()
//Return to the dialog to buy something
function capture_the_order(po)
//Use the google.script.run API to call the server
//This is specific to Google Apps Script
return new Promise (function (resolve,reject)
google.script.run
.withSuccessHandler (function (result)
//cl('result 62' + result)
resolve (result);//What resolve does is return the result from the server back to the FIRST anonymous function in the "then" part
)
.withFailureHandler (function (error)
//cl('error 66' + error)
reject (error);
)
.captureThePayment(po);//Call the server to create a PayPal order
)
function iWillWaitForU()
//Use the google.script.run API to call the server
//This is specific to Google Apps Script
return new Promise (function (resolve,reject)
google.script.run
.withSuccessHandler (function (result)
//cl('result 62' + result)
resolve (result);//What resolve does is return the result from the server back to the FIRST anonymous function in the "then" part
)
.withFailureHandler (function (error)
//cl('error 66' + error)
reject (error);
)
.createA_PayPalOrder();//Call the server to create a PayPal order
)
function initPayPalButton()
/*
This is a server side integration of the client side PayPal JavaScript SDK -
The createOrder method makes a call to the PayPal API -
The PayPal documentation uses the fetch() method but Apps Script uses google.script.run
to make a server call so the PayPal example must be modified -
*/
paypal.Buttons(
style:
shape: 'rect',
color: 'gold',
layout: 'vertical',
label: 'paypal',
,
createOrder : function()
//console.log('createOrder 93' + 'order')
return iWillWaitForU()// Call the server code to complete the payment transaction
//This both creates and executes the transaction
.then(function(response)
//console.log('response 89' + response)
return JSON.parse(response);
//window.PayPalOrderId = orderInfo.id;
//return orderInfo.id;
,//THERE MUST BE A COMMA HERE!!!! This is a list of functions seperated by a comma
function (error) //Because this is the second function this is what gets called for an error
showModalMessageBox("There was an error in the PayPal button!","ERROR!");
//console.log(error);
return "Error";
).then(
function(orderObj)
//console.log('orderObj.orderID' + orderObj.id)
return orderObj.id;
);
,
onApprove: function()
//console.log('onapprove ran')
startSpinner();
backToStartPay();
capture_the_order("which":"capture","orderId":window.PayPalOrderId)
.then(
function(hadSuccess)
//cl('hadSuccess 89',hadSuccess)
if (hadSuccess)
payPalPaymentComplete();
//console.log('Transaction completed !');
else
showModalMessageBox("There was an error getting the payment!","ERROR!");
//console.log(error);
stopSpinner();
,//THERE MUST BE A COMMA HERE!!!! This is a list of functions seperated by a comma
function (error) //Because this is the second function this is what gets called for an error
showModalMessageBox("There was an error getting the payment!","ERROR!");
//console.log(error);
stopSpinner();
)
,
onCancel: function (data, actions)
// Show a cancel page or return to cart
showModalMessageBox('PayPal Session was cancelled',"CANCELLED!");
backToStartPay();
,
onError: function(err)
showModalMessageBox("There was an error in the PayPal button!","ERROR!");
//console.log(err);
).render('#paypal-button-container');//Render the PayPal button into the html element with id #paypal-button-container -
//See HTML file - H_PayPal_New
initPayPalButton();
</script>
【讨论】：
以上是关于带有服务器集成的 PayPal 客户端 JavaScript SDK - 设置付款金额的主要内容，如果未能解决你的问题，请参考以下文章
Paypal Checkout 客户端集成 - 返回订单 ID 承诺的问题