ãŠã§ãäžã§åççãã€å®å šãªæ±ºæžåŠçãå¯èœã«ãããã©ãŠã¶æšæºãPayment Request APIã解説ãã·ãŒã ã¬ã¹ãªã°ããŒãã«ECäœéšãå®çŸããããã®çµ±åæ¹æ³ã玹ä»ããŸãã
ããã³ããšã³ã Payment Request APIïŒã°ããŒãã«ãªé¡§å®¢ã«åããæ±ºæžåŠçã®åçå
仿¥ã®ã°ããŒãã«ãªeã³ããŒã¹ã®äžçã§ã¯ãã·ãŒã ã¬ã¹ã§å®å šãªæ±ºæžäœéšãæäŸããããšãã顧客ãåŒãã€ããç¶æããããã«äžå¯æ¬ ã§ããPayment Request API (PR API) ã¯ããã©ãŠã¶å ã§çŽæ¥æ¯æããåŠçããããã®æšæºåãããæ¹æ³ãæäŸãããã§ãã¯ã¢ãŠãããã»ã¹ãç°¡çŽ åããã»ãã¥ãªãã£ã匷åããŸãããã®ããã°èšäºã§ã¯ãPayment Request APIã«ã€ããŠè©³ããæãäžãããã®å©ç¹ãå®è£ æ¹æ³ããããŠã°ããŒãã«ãªé¡§å®¢åãã®ãã¹ããã©ã¯ãã£ã¹ã«ã€ããŠè§£èª¬ããŸãã
Payment Request APIãšã¯ïŒ
Payment Request APIã¯ãããŒãã£ã³ãããŠãŒã¶ãŒã®ãã©ãŠã¶ãã¢ãã€ã«ããã€ã¹ããçŽæ¥æ¯æãæ å ±ãèŠæ±ããåãåãããšãå¯èœã«ãããŠã§ãæšæºã§ããããã¯ãããŒãã£ã³ãã®ãŠã§ããµã€ããšããã©ãŠã¶ã«ä¿åãããŠããã¯ã¬ãžããã«ãŒããGoogle PayãApple Payã®ãããªããžã¿ã«ãŠã©ã¬ãããããã«ã¯éè¡æ¯èŸŒãšãã£ããŠãŒã¶ãŒã®å¥œãæ¯æãæ¹æ³ãšã®éã®äžéçãªåœ¹å²ãæãããŸãã
ãŠãŒã¶ãŒãæåã§æ¯æãæ å ±ãé éå æ å ±ãå ¥åããå¿ èŠãããåŸæ¥ã®ãã§ãã¯ã¢ãŠããã©ãŒã ã«é Œã代ããã«ãPR APIã¯ãã©ãŠã¶å ã§çŽæ¥ãæšæºåãããæ¯æãã·ãŒããæç€ºããŸãããã®ã·ãŒãã¯ããŠãŒã¶ãŒããã§ã«ä¿åããŠããæ¯æãæ¹æ³ãéçŽããã¯ã³ã¯ãªãã¯ãŸãã¯ã¯ã³ã¿ããã§å¥œã¿ã®æ¹æ³ãéžæããååŒã確å®ã§ããããã«ããŸãã
Payment Request APIã䜿çšããã¡ãªãã
Payment Request APIã¯ãããŒãã£ã³ããšé¡§å®¢ã®åæ¹ã«ããã€ãã®å€§ããªå©ç¹ããããããŸãïŒ
1. ã³ã³ããŒãžã§ã³çã®åäž
ãã§ãã¯ã¢ãŠãããã»ã¹ãåçåããè³Œå ¥ãå®äºããããã«å¿ èŠãªã¹ãããæ°ãæå°éã«æããããšã§ãPR APIã¯ã³ã³ããŒãžã§ã³çãå€§å¹ ã«åäžãããããšãã§ããŸããæšæºåãããæ¯æãã·ãŒãã¯ããŠãŒã¶ãŒã«äžè²«æ§ã®ãã芪ãã¿ãããäœéšãæäŸããããªã¯ã·ã§ã³ãæžãããååŒã®å®äºãä¿é²ããŸãã
äŸãã°ãGoogleã®èª¿æ»ã«ãããšãPayment Request APIã䜿çšããŠãããŠã§ããµã€ãã¯ãåŸæ¥ã®ãã§ãã¯ã¢ãŠããããŒã䜿çšããŠãããµã€ããšæ¯èŒããŠãã³ã³ããŒãžã§ã³çã12%å¢å ããããšã瀺ãããŠããŸãã
2. ã»ãã¥ãªãã£ã®åŒ·å
Payment Request APIã¯ãããŒãã£ã³ããæ©å¯æ§ã®é«ãæ¯æãããŒã¿ã«è§Šããæ©äŒãæžããããšã§ãã»ãã¥ãªãã£ã匷åããŸããããŒãã£ã³ãã¯ãã¯ã¬ãžããã«ãŒãæ å ±ãçŽæ¥åéã»ä¿åãã代ããã«ã決æžãããã€ããŒããããŒã¯ã³åãããæ¯æãèªèšŒæ å ±ãåãåããŸãããã®ããŒã¯ã³ã¯ãå®éã®ã«ãŒãçªå·ããã®ä»ã®æ©å¯æ å ±ãæããããšãªããé¡§å®¢ã®æ¯æã詳现ã衚ããŸãã
ãã®ããŒã¯ã³åããã»ã¹ã«ãããããŒãã£ã³ãã¯èªç€ŸãµãŒããŒã§æ©å¯æ§ã®é«ãæ¯æãããŒã¿ãä¿åã»ä¿è·ããå¿ èŠããªããªããããããŒã¿æŒæŽ©ãäžæ£è¡çºã®ãªã¹ã¯ãæžå°ããŸãã
3. ã«ãŽèœã¡ã®åæž
é·ãè€éãªãã§ãã¯ã¢ãŠãããã»ã¹ã¯ãã«ãŽèœã¡ã®äž»ãªåå ã§ãããã§ãã¯ã¢ãŠãäœéšãç°¡çŽ åãããŠãŒã¶ãŒã«èŠæ±ããæ å ±éãæžããããšã§ãPR APIã¯ã«ãŽèœã¡çã®åæžã«è²¢ç®ããŸãã
PR APIã«ãã£ãŠæäŸãããäºåå ¥åæžã¿ã®æ¯æãæ å ±ãšé éå æ å ±ã«ããããŠãŒã¶ãŒãæåã§è©³çްãå ¥åããå¿ èŠããªããªããæéãšæéãçãããè³Œå ¥ãå®äºããå¯èœæ§ãé«ãŸããŸãã
4. ã¢ãã€ã«ãã¬ã³ããªãŒãªäœéš
Payment Request APIã¯ãã¢ãã€ã«ããã€ã¹ã§ã·ãŒã ã¬ã¹ã«åäœããããã«èšèšãããŠãããã¢ãã€ã«ãŠãŒã¶ãŒã«äžè²«æ§ã®ããæé©åããããã§ãã¯ã¢ãŠãäœéšãæäŸããŸããæ¯æãã·ãŒãã¯ãŠãŒã¶ãŒã®ç»é¢ãµã€ãºãããã€ã¹ã«é©å¿ãããããå€åºå ã§ãç°¡åã«è³Œå ¥ãå®äºã§ããŸãã
ã¢ãã€ã«ã³ããŒã¹ã®äººæ°ãé«ãŸãäžãã¢ãã€ã«ãã¬ã³ããªãŒãªæ±ºæžäœéšãæäŸããããšã¯ãããåºã顧客局ã«ãªãŒããã売äžãæå€§åããããã«äžå¯æ¬ ã§ãã
5. ã°ããŒãã«ãªå¯Ÿå¿å
Payment Request APIã¯ãããŸããŸãªæ¯æãæ¹æ³ãšé貚ããµããŒãããŠãããããã°ããŒãã«ãªeã³ããŒã¹ç°å¢ã§ã®äœ¿çšã«é©ããŠããŸããããŸããŸãªæ±ºæžã²ãŒããŠã§ã€ãããã»ããµãŒãšçµ±åããŠãç°ãªãå°åã§é¡§å®¢ã奜ãããŸããŸãªæ¯æãæ¹æ³ããµããŒãã§ããŸãã
äŸãã°ãåœã«ãã£ãŠã¯ãã¯ã¬ãžããã«ãŒããããéè¡æ¯èŸŒãå°åã®æ±ºæžæ¹æ³ã人æ°ã®å ŽåããããŸããPR APIã¯ããããã®ä»£æ¿æ±ºæžæ¹æ³ããµããŒãããããã«èšå®ã§ããããŒãã£ã³ããããŸããŸãªåžå Žã®é¡§å®¢ã®å¥œã¿ã«å¿ããããšãå¯èœã«ããŸãã
Payment Request APIã®å®è£
Payment Request APIã®å®è£ ã«ã¯ãããã€ãã®éèŠãªã¹ããããå«ãŸããŸãïŒ
1. ãã©ãŠã¶ã®ãµããŒãç¶æ³ã確èªãã
Payment Request APIãå®è£ ããåã«ããŠãŒã¶ãŒã®ãã©ãŠã¶ãããããµããŒãããŠãããã©ããã確èªããããšãéèŠã§ããããã¯ã次ã®JavaScriptã³ãŒãã䜿çšããŠè¡ãããšãã§ããŸãïŒ
if (window.PaymentRequest) {
// Payment Request API is supported
} else {
// Payment Request API is not supported
}
2. æ¯æã詳现ãå®çŸ©ãã
次ã®ã¹ãããã¯ãåèšéé¡ãé貚ããµããŒããããŠããæ¯æãæ¹æ³ãå«ãæ¯æã詳现ãå®çŸ©ããããšã§ãããã®æ å ±ã¯PaymentRequestã³ã³ã¹ãã©ã¯ã¿ã«æž¡ãããŸãã
const supportedPaymentMethods = [
{
supportedMethods: ['basic-card', 'https://android.com/pay', 'https://apple.com/apple-pay'],
data: {
supportedNetworks: ['visa', 'mastercard', 'amex'],
countryCode: 'US',
},
},
];
const paymentDetails = {
total: {
label: 'Total',
amount: {
currency: 'USD',
value: '10.00',
},
},
};
const paymentOptions = {
requestPayerName: true,
requestPayerEmail: true,
requestPayerPhone: true,
requestShipping: true,
};
ãã®äŸã§ã¯ãåºæ¬çãªã¯ã¬ãžããã«ãŒããGoogle PayãApple PayããµããŒãããŠããŸãããŸããæ¯æè ã®ååãã¡ãŒã«ã¢ãã¬ã¹ãé»è©±çªå·ãé éå äœæããªã¯ãšã¹ãããŠããŸãã
3. PaymentRequestãªããžã§ã¯ããäœæãã
æ¯æã詳现ãšãªãã·ã§ã³ãå®çŸ©ããããPaymentRequestãªããžã§ã¯ããäœæã§ããŸãïŒ
const paymentRequest = new PaymentRequest(supportedPaymentMethods, paymentDetails, paymentOptions);
4. æ¯æãã·ãŒãã衚瀺ãã
ãŠãŒã¶ãŒã«æ¯æãã·ãŒãã衚瀺ããã«ã¯ãPaymentRequestãªããžã§ã¯ãã®show()ã¡ãœãããåŒã³åºããŸãïŒ
paymentRequest.show()
.then(paymentResponse => {
// Handle the payment response
console.log(paymentResponse);
return paymentResponse.complete('success');
})
.catch(error => {
// Handle the error
console.error(error);
});
show()ã¡ãœããã¯ããŠãŒã¶ãŒãæäŸããæ¯æã詳现ãå«ãPaymentResponseãªããžã§ã¯ãã§è§£æ±ºãããPromiseãè¿ããŸãããã®åŸããã®æ
å ±ã䜿çšããŠã決æžã²ãŒããŠã§ã€ãããã»ããµãŒã§æ¯æããåŠçã§ããŸãã
PaymentResponseãªããžã§ã¯ãã®complete()ã¡ãœããã¯ãæ¯æããæåãããã©ããã瀺ãããã«åŒã³åºãå¿
èŠããããŸããcomplete()ã¡ãœããã«'success'ãæž¡ããšãæ¯æãã·ãŒããéããããæ¯æããæåããããšã瀺ããŸãã'fail'ãæž¡ããšãæ¯æãã倱æããããšã瀺ããŸãã
5. æ¯æãã¬ã¹ãã³ã¹ãåŠçãã
PaymentResponseãªããžã§ã¯ãã«ã¯ãæ¬¡ã®æ å ±ãå«ãŸããŠããŸãïŒ
- payerName: æ¯æè ã®ååã
- payerEmail: æ¯æè ã®ã¡ãŒã«ã¢ãã¬ã¹ã
- payerPhone: æ¯æè ã®é»è©±çªå·ã
- shippingAddress: æ¯æè ã®é éå äœæã
- methodName: 䜿çšãããæ¯æãæ¹æ³ã
- details: ã«ãŒãçªå·ãããŒã¯ã³ãªã©ã®æ¯æã詳现ã
ãã®æ å ±ã䜿çšããŠã決æžã²ãŒããŠã§ã€ãããã»ããµãŒã§æ¯æããåŠçã§ããŸããæ¯æããåŠçããå ·äœçãªæé ã¯ã䜿çšããŠããæ±ºæžã²ãŒããŠã§ã€ãããã»ããµãŒã«ãã£ãŠç°ãªããŸãã
Payment Request APIã䜿çšããããã®ãã¹ããã©ã¯ãã£ã¹
顧客ã«ã¹ã ãŒãºã§å®å šãªæ±ºæžäœéšãä¿èšŒããããã«ãPayment Request APIã䜿çšããéã«ã¯ã以äžã®ãã¹ããã©ã¯ãã£ã¹ã«åŸã£ãŠãã ããïŒ
1. æç¢ºã§ç°¡æœãªæ å ±ãæäŸãã
è³Œå ¥ãããååããµãŒãã¹ãããã³æ¯æç·é¡ã«ã€ããŠãæç¢ºã§ç°¡æœãªæ å ±ãæäŸããŠãã ãããããã«ãããæ··ä¹±ãé¿ãã顧客ãäœã«å¯ŸããŠæ¯æã£ãŠããã®ãã確å®ã«çè§£ã§ããããã«ãªããŸãã
2. è€æ°ã®æ¯æãæ¹æ³ããµããŒããã
ããŸããŸãªå°åã®é¡§å®¢ã®å¥œã¿ã«å¿ããããã«ã倿§ãªæ¯æãæ¹æ³ããµããŒãããŠãã ãããããã«ã¯ãã¯ã¬ãžããã«ãŒããããžã¿ã«ãŠã©ã¬ãããéè¡æ¯èŸŒãå°åã®æ±ºæžæ¹æ³ãªã©ãå«ãŸããŸãã
3. å®å šãªæ¥ç¶ã確ä¿ãã
æ¯æããåŠçããéã¯ãåžžã«å®å šãªæ¥ç¶ïŒHTTPSïŒã䜿çšããŠãã ãããããã«ãããæ©å¯æ§ã®é«ãæ¯æãããŒã¿ãäžæ£ãªç¬¬äžè ã«ãã£ãŠååãããã®ãé²ãããšãã§ããŸãã
4. ãšã©ãŒãé©åã«åŠçãã
ãšã©ãŒãé©åã«åŠçãããŠãŒã¶ãŒã«æçãªãšã©ãŒã¡ãã»ãŒãžãæäŸããŠãã ãããããã«ããããã©ã¹ãã¬ãŒã·ã§ã³ãé²ãã顧客ãè³Œå ¥ãç¡äºã«å®äºã§ããããã«ãªããŸãã
5. 培åºçã«ãã¹ããã
Payment Request APIã®å®è£ ãæ£ããæ©èœããŠããããšã確èªããããã«ã培åºçã«ãã¹ãããŠãã ãããããã«ã¯ãããŸããŸãªæ¯æãæ¹æ³ããã©ãŠã¶ãããã€ã¹ã§ã®ãã¹ããå«ãŸããŸãã
Payment Request APIå®è£ ã«ãããã°ããŒãã«ãªèæ ®äºé
Payment Request APIãã°ããŒãã«ãªé¡§å®¢åãã«å®è£ ããéã«ã¯ã次ã®ç¹ãèæ ®ããŠãã ããïŒ
1. é貚ã®ãµããŒã
決æžã²ãŒããŠã§ã€ãšPayment Request APIãã顧客ã䜿çšããé貚ããµããŒãããããã«èšå®ãããŠããããšã確èªããŠãã ãããæ··ä¹±ãé¿ããããã«ãäŸ¡æ Œã¯é¡§å®¢ã®çŸå°é貚ã§è¡šç€ºããŸãã
äŸãã°ããšãŒãããã®é¡§å®¢ã¯ãŠãŒãïŒEURïŒã§ã®æ¯æãã奜ã¿ãæ¥æ¬ã®é¡§å®¢ã¯æ¥æ¬åïŒJPYïŒã§ã®æ¯æãã奜ããããããŸããã
2. ããŒã«ã©ã€ãŒãŒã·ã§ã³
æ¯æãã·ãŒããšé¢é£ã¡ãã»ãŒãžã顧客ã®èšèªã«ããŒã«ã©ã€ãºããŠãã ãããããã«ããããŠãŒã¶ãŒãšã¯ã¹ããªãšã³ã¹ãåäžãã顧客ãè³Œå ¥ãå®äºãããããªããŸãã
3. æ¯æãæ¹æ³ã®å¥œã¿
å°åã«ããæ¯æãæ¹æ³ã®å¥œã¿ãèªèããŠãã ãããäžéšã®åœã§ã¯ã¯ã¬ãžããã«ãŒããäž»èŠãªæ¯æãæ¹æ³ã§ãããä»ã®åœã§ã¯éè¡æ¯èŸŒãããžã¿ã«ãŠã©ã¬ãããªã©ã®ä»£æ¿æ±ºæžæ¹æ³ãããäžè¬çã§ãã
äŸãã°ããã€ãã§ã¯ãå£åº§æ¯æ¿ïŒSEPAãã€ã¬ã¯ãããããïŒãäžè¬çã«äœ¿çšãããæ¯æãæ¹æ³ã§ãã
4. èŠå¶ã³ã³ãã©ã€ã¢ã³ã¹
ããžãã¹ãè¡ãåœã ã®æ±ºæžåŠçã«é¢é£ãããã¹ãŠã®é©çšèŠå¶ãéµå®ããŠãã ãããããã«ã¯ãããŒã¿ãã©ã€ãã·ãŒãæ¶è²»è ä¿è·ãäžæ£é²æ¢ã«é¢é£ããèŠå¶ãå«ãŸããå ŽåããããŸãã
äŸãã°ã欧å·é£åã®äžè¬ããŒã¿ä¿è·èŠåïŒGDPRïŒã¯ãæ¯æãæ å ±ãå«ãå人ããŒã¿ã®åŠçã«å³ããèŠä»¶ã課ããŠããŸãã
5. éæãšçšéã®èšç®
é¡§å®¢ã®æåšå°ã«åºã¥ããŠãéæãšçšéãæ£ç¢ºã«èšç®ããŠãã ããã顧客ãè³Œå ¥ãå®äºããåã«ããããã®è²»çšã«é¢ããæç¢ºã§éææ§ã®ããæ å ±ãæäŸããŸãã
Payment Request APIã䜿çšããŠããäŒæ¥ã®äŸ
ããã€ãã®äŒæ¥ã¯ããã§ãã¯ã¢ãŠãããã»ã¹ãåçåãã顧客äœéšãåäžãããããã«ããã§ã«Payment Request APIãå°å ¥ããŠããŸãã以äžã«ããã€ãã®äŸãæããŸãïŒ
- Alibaba: äžçæå€§ã®ãªã³ã©ã€ã³å°å£²æ¥è ã¯ã顧客ã®ãã§ãã¯ã¢ãŠãããã»ã¹ãç°¡çŽ åããããã«Payment Request APIã䜿çšããŠããŸãã
- eBay: ãªã³ã©ã€ã³ãªãŒã¯ã·ã§ã³ããã³eã³ããŒã¹ãã©ãããã©ãŒã ã¯ããŠãŒã¶ãŒã«ã·ãŒã ã¬ã¹ãªæ±ºæžäœéšãæäŸããããã«Payment Request APIãçµ±åããŠããŸãã
- Shopify: ãã®eã³ããŒã¹ãã©ãããã©ãŒã ã¯Payment Request APIããµããŒãããŠããããã®ããŒãã£ã³ãã顧客ã«åçåããããã§ãã¯ã¢ãŠãããã»ã¹ãæäŸã§ããããã«ããŠããŸãã
Payment Request APIã®æªæ¥
Payment Request APIã¯åžžã«é²åããŠãããæ°ããæ©èœãæ¹åã宿çã«è¿œå ãããŠããŸããå°æ¥ã®æœåšçãªçºå±ã«ã¯ã以äžã®ãããªãã®ããããŸãïŒ
- æ¯æãæ¹æ³ãµããŒãã®æ¡å€§: APIã¯ãæå·é貚ããããã¯ãã§ãŒã³ããŒã¹ã®æ¯æããªã©ã远å ã®æ¯æãæ¹æ³ããµããŒãããããã«æ¡åŒµãããå¯èœæ§ããããŸãã
- ã»ãã¥ãªãã£ã®åäž: æ©å¯æ§ã®é«ãæ¯æãããŒã¿ãããã«ä¿è·ããããã«ãæ°ããã»ãã¥ãªãã£æ©èœã远å ãããå¯èœæ§ããããŸãã
- ä»ã®ãŠã§ãæè¡ãšã®é£æºåŒ·å: APIã¯ãWeb Authentication (WebAuthn) ãªã©ã®ä»ã®ãŠã§ãæè¡ãšçµ±åãããããå®å šã§ãŠãŒã¶ãŒãã¬ã³ããªãŒãªèªèšŒäœéšãæäŸããå¯èœæ§ããããŸãã
çµè«
Payment Request APIã¯ãããŒãã£ã³ããæ±ºæžåŠçãåçåããã³ã³ããŒãžã§ã³çãåäžãããã»ãã¥ãªãã£ã匷åããã®ã«åœ¹ç«ã€åŒ·åãªããŒã«ã§ããæšæºåããç°¡çŽ åããããã§ãã¯ã¢ãŠãäœéšãæäŸããããšã§ãPR APIã¯é¡§å®¢äœéšãå€§å¹ ã«åäžããã売äžã䌞ã°ãããšãã§ããŸãã
ãã®ããã°èšäºã§æŠèª¬ãããã¹ããã©ã¯ãã£ã¹ã«åŸããå®è£ ã«é¢ããã°ããŒãã«ãªèæ ®äºé ãèæ ®ããããšã§ãPayment Request APIãeã³ããŒã¹ãŠã§ããµã€ãã«ããŸãçµ±åããäžçäžã®é¡§å®¢ã«ã·ãŒã ã¬ã¹ã§å®å šãªæ±ºæžäœéšãæäŸããããšãã§ããŸãããã®æè¡ã掻çšããŠãã°ããŒãã«ãªeã³ããŒã¹åžå Žã§ç«¶äºåãç¶æãã顧客ãã©ãã«ããŠãåªããäœéšãæäŸããŸãããã