Lotte Card

• Overview
• Countries & currencies
• Integration
• Process flows
• Testing
• Additional information
• Consumer experience
• Reporting
• FAQ

Integration

• Using MyCheckout hosted payment pages
• Using your own checkout page

Before you begin

To follow along with this guide, please ensure that you have the following ready:

• The correct API endpoint
• A way to construct the authorization header(our API Explorer, our SDKs, etc.)
• A way to send RESTful API calls (our API Explorer, our SDKs, etc.)

MyCheckout hosted payment pages

1. Make a POST /v1/{merchantId}/hostedcheckouts API call.
2. Create the order object containing the following elements:

• amountOfMoney, including amount and currencyCode
• customer, including billingAddress and countryCode

{
    "order": {
        "amountOfMoney": {
            "amount": 100,
            "currencyCode": "KRW"
        },
        "customer": {
            "billingAddress": {
                "countryCode": "KR"
            }
        }
    }
}

{
   "RETURNMAC" : "33893c8a-1e6f-4e02-9015-9d4e34b08d41",
   "hostedCheckoutId" : "0634e88f-7255-71ff-860e-3f55f70978cc",
   "partialRedirectUrl" : "pay2.preprod.checkout.worldline-solutions.com/checkout/88005-7f4cdb166ccb4712930c6df0028d4283:065d3625-ed4f-71ff-9de6-6bf8c2c79ebf:bb9b2eee735c43aab6db5513ee170983"
}

From the response, the important properties are:

• hostedCheckoutId – can be used in subsequent API calls to retrieve the transaction details, such as GET/v1/{merchantId}/hostedcheckouts/{hostedCheckoutId}
• partialRedirectUrl – is used to create the URL to which the customer needs to be redirected (by default, we configure every account with the subdomain payment, so you can always connect https://payment. with the partialRedirectUrl, for example:

https://payment.pay2.preprod.checkout.worldline-solutions.com/checkout/88005-7f4cdb166ccb4712930c6df0028d4283:065d3625-ed4f-71ff-9de6-6bf8c2c79ebf:bb9b2eee735c43aab6db5513ee170983

Using your own checkout page 

You can build a direct integration using our SDKs (or integrate our API from scratch). Depending on your integration needs, there are several options available.

Client Encryption

Our Client API allows you to perform various actions, such as collecting card data without being PCI SAQ-D compliant. All you need is to be able to create a session via the POST/v1/{merchantId}/sessions API call, which will grant you access to the Client API.

It's highly recommended that you use our Client SDKs, provided for the following programming languages:

• Flutter
• Android
• Swift
• iOS (Objective-C)

We also have reference implementations showing how to use these SDKs on GitHub

Raw data

If you wish to do a direct server-to-server API call, go for this option. The difference with the other options mentioned before is that you don't need to submit an encryptedCustomerInput property. After the customer selects the payment product, you need to perform the following:

1. Make a POST /v1/{merchantId}/payments API call.
2. Create the order object requiring the following properties:

• amountOfMoney, including amount and currencyCode
• customer, including billingAddress and countryCode

1. Create the cardPaymentMethodSpecificInput object requiring the following properties:

• paymentProductId
• card, including partialPin, cardNumber, and expiryDate 

{
    "order": {
        "amountOfMoney": {
            "amount": 100,
            "currencyCode": "KRW"
        },
        "customer": {
            "billingAddress": {
                "countryCode": "KR"
            }
        }
    },
    "cardPaymentMethodSpecificInput": {
        "paymentProductId": 184,
        "card": {
            "partialPin": "12",
            "cardNumber": "4889066880805972",
            "expiryDate": "1224"
        }
    }
}

{
   "creationOutput" : {
      "additionalReference" : "00000099601000010577",
      "externalReference" : "000000996010000105770000100001"
   },
   "payment" : {
      "id" : "000000996010000105770000100001",
      "paymentOutput" : {
         "amountOfMoney" : {
            "amount" : 100,
            "currencyCode" : "KRW"
         },
         "references" : {
            "paymentReference" : "0",
            "providerId" : "3700",
            "providerReference" : "0996010000105770000100001"
         },
         "paymentMethod" : "card",
         "cardPaymentMethodSpecificOutput" : {
            "paymentProductId" : 184,
            "authorisationCode" : "AUTH00000290",
            "fraudResults" : {
               "fraudServiceResult" : "no-advice",
               "avsResult" : "0",
               "cvvResult" : "0"
            },
            "card" : {
               "cardNumber" : "488906******5972", 
               "expiryDate" : "1224"
            }
         }
      },
      "status" : "CAPTURE_REQUESTED",
      "statusOutput" : {
         "isCancellable" : false,
         "isRetriable" : false,
         "statusCategory" : "PENDING_CONNECT_OR_3RD_PARTY",
         "statusCode" : 975,
         "statusCodeChangeDateTime" : "20231017132929",
         "isAuthorized" : true,
         "isRefundable" : true
      }
   }
}