Webservice payments
This payment process consists of three phases:
- Generate the payment order.
- The merchant sends the payment characteristics to the
/paymentendpoint. - Paylands returns an
orderobject along with itsUUIDwhich will be used to finalize the payment. - IMPORTANT: with this method, the
customer_ext_idfield sent to/paymentis mandatory, and must match thecustomer_ext_idused when saving the card in the system.
- The merchant sends the payment characteristics to the
- Complete the payment
- The merchant completes the payment with the
UUIDof theorderand theUUIDof thecardstored in the system. For this, a request has to be made to the/payment/directendpoint. - The UUID of the card can be obtained from the notification of a previously completed payment or from the response of saving a card in the system.
- If a new card is to be used, it must first be tokenized to obtain the corresponding UUID.
- Paylands checks this data, processes the order and synchronously returns the result of the transaction.
- Depending on the card issuing bank, the bank may require the transaction to be finalized by 3DS, which requires user intervention. In this case the response will contain a URL which the merchant must redirect the user to finalize the payment.
- The merchant completes the payment with the
- Notification
- If a
url_postwas sent when generating the payment order, the merchant receives the notification at this url - The
orderobject updated with the result of the operation is received.
- If a
