With the peach payments restful API, a developer can tokenize cards and use the stored token for subscription or one-click payments.
This can be done using our Copy & Pay or Server-to-Server API. The Copy & Pay flow can be found in the article Copy + Pay Recurring Payment Flow.
Below you find the way to construct the initial POST request for a Server-to-Server flow:
Documentation here: https://peachpayments.docs.oppwa.com/
Request:
*Adding the parameter createRegistration=true in the request tokenizes the card.
*There are other COF parameters that will need to be included - read more on COF here
entityId=8a8294174e735d0c014e78cf26461790
amount=92.00
currency=ZAR
paymentBrand=MASTER
paymentType=DB
card.number=5454545454545454
card.holder=Jane Jones
card.expiryMonth=05
card.expiryYear=2020
card.cvv=123
createRegistration=true
standingInstruction.source=CIT
standingInstruction.mode=INITIAL
standingInstruction.type=UNSCHEDULED
shopperResultUrl=https://www.google.com
You will then need to handle the 3DS2 method data that gets sent back to you by the customer's Issuing Bank's ACS system - see the documentation link listed about for more information on how to do this.
Response:
*The registration id in the final GET status response is the token.
{
"id":"8ac7a4a2708062d70170856fe76e4e29",
"registrationId":"8ac7a4a17085444d0170856fe61d33cf",
"paymentType":"DB",
"paymentBrand":"MASTER",
"amount":"92.00",
"currency":"ZAR",
"descriptor":"5924.8723.1747 OPP_Channel ",
"result":{
"code":"000.100.110",
"description":"Request successfully processed in 'Merchant in Integrator Test Mode'"
},
"card":{
"bin":"545454",
"last4Digits":"5454",
"holder":"Jane Jones",
"expiryMonth":"05",
"expiryYear":"2020"
},
"customParameters":{
"OPP_card.bin":"545454"
},
"risk":{
"score":"100"
},
"buildNumber":"88f50db9d2065c23a84dea4c9e6a6a81dc205921@2020-02-25 17:06:59 +0000",
"timestamp":"2020-02-27 06:57:48+0000",
"ndc":"8a8294174e735d0c014e78cf26461790_a40178a5c32f4d3086bb73cd26d9e7f8"
}
Making Recurring Payments with the registration token generated:
Here is our recurring payment documentation: https://peachpayments.docs.oppwa.com/tutorials/card-on-file
Recurring API: