--- title: "Cartes Bancaires" canonical_url: https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/integration/globalcollect --- * [Overview](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/overview.md) * [Countries \& currencies](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/countries-and-currencies.md) * [Integration](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/integration.md) * [Process flows](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/process-flows.md) * [Testing](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/testing.md) * [Additional information](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/additional-information.md) * [Consumer experience](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/consumer-experience.md) * [Reporting](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/reporting.md) * [FAQ](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/faqs.md) # Integration * [Using MyCheckout hosted payment pages](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/integration/globalcollect.md#mycheckout) * [Using your own checkout page](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/integration/globalcollect.md#own-checkout) * [Client encryption](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/integration/globalcollect.md#client-encryption) * [Non-encrypted data](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/integration/globalcollect.md#non-encrypted-data) ## Before you begin To follow along with this guide, please ensure that you have the following ready: * The correct [API endpoint](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/json/endpoints.html?paymentPlatform=ALL) * A way to construct the [authorization header](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/json/authentication.html?paymentPlatform=ALL) (API Explorer,[SDKs](https://docs.connect.worldline-solutions.com/documentation/sdk/.md), etc.) * A way to send REST API calls (API Explorer,[SDKs](https://docs.connect.worldline-solutions.com/documentation/sdk/.md), etc.) ## Using MyCheckout hosted payment pages Since we host the pages ourselves and manage the card data on your behalf, you are only required to comply with [PCI SAQ A](https://docs.connect.worldline-solutions.com/accepting-payments/compliance/pci-dss.md) standards, which are less strict than higher-level requirements. 1. Make a [POST /v1/{merchantId}/hostedcheckouts](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/java/hostedcheckouts/create.html?paymentPlatform=ALL) API call. 2. Create the order object containing the following elements: * amountOfMoney, including amount and currencyCode * customer, including billingAddress and countryCode Additionally, you can add hostedCheckoutSpecificInput object, featuring variant and locale properties: * variant - the created styling of the checkout page tailored to your consumer's preferences * locale - the language, that will be used for your hosted checkout page For more information on customizing the MyCheckout hosted payment pages, please [refer to our detailed guide](https://docs.connect.worldline-solutions.com/documentation/hosted-payment-pages/.md). POST HOSTEDCHECKOUTS REQUESTCopy { "order": { "amountOfMoney": { "amount": 100, "currencyCode": "EUR" }, "customer": { "billingAddress": { "countryCode": "FR" } } }, "hostedCheckoutSpecificInput": { "variant": "124", "locale": "en_GB" } } POST HOSTEDCHECKOUTS RESPONSECopy { "RETURNMAC" : "e0709a2b-8e03-4ae3-8dfa-32e78f6c1f6a", "hostedCheckoutId" : "065d8813-a5b1-71ff-8e45-385a864611d5", "partialRedirectUrl" : "pay1.preprod.checkout.worldline-solutions.com/checkout/9992-7654d37bf05f42b2a6141cbeb7f7efab:065d8813-a5b1-71ff-8e45-385a864611d5:6ce609c7c3994bbb94709035baaeb33c" } 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}](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/java/hostedcheckouts/get.html?paymentPlatform=ALL) * 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.pay1.preprod.checkout.worldline-solutions.com/checkout/9992-7654d37bf05f42b2a6141cbeb7f7efab:065d8813-a5b1-71ff-8e45-385a864611d5:6ce609c7c3994bbb94709035baaeb33c The hostedCheckoutId is only valid for 2 hours, please ensure to store the createdPaymentOutput.payment.id from the [GET /v1/{merchantId}/hostedcheckouts/{hostedCheckoutId}](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/java/hostedcheckouts/get.html?paymentPlatform=ALL) response to be able to retrieve data after 2 hours have elapsed via the [GET /v1/{merchantId}/payments/{paymentId}](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/json/payments/get.html?paymentPlatform=ALL) API call. Alternatively, we can also optionally send a [webhook event](https://docs.connect.worldline-solutions.com/documentation/webhooks/index.md) that will contain it. ## Using your own checkout page You can build a direct integration using our [SDKs](https://docs.connect.worldline-solutions.com/documentation/sdk/index.md) (or integrate our API from scratch). Depending on your integration needs, there are several options available. ### Client encryption Our [Client API](https://apireference.connect.worldline-solutions.com/c2sapi/v1/en_US/index.html?paymentPlatform=ALL) allows you to perform various actions, such as collecting card data without being [PCI SAQ D](https://docs.connect.worldline-solutions.com/accepting-payments/compliance/pci-dss.md) compliant. All you need is to be able to create a session via the [POST/v1/{merchantId}/sessions](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/json/sessions/create.html?paymentPlatform=ALL) API call, which will grant you access to the Client API. It's highly recommended that you use our [Client SDKs](https://docs.connect.worldline-solutions.com/documentation/sdk/mobile/.md), provided for the following programming languages: * [JavaScript](https://docs.connect.worldline-solutions.com/documentation/sdk/mobile/javascript/.md) * [Java](https://docs.connect.worldline-solutions.com/documentation/sdk/mobile/android/.md) * [Swift](https://docs.connect.worldline-solutions.com/documentation/sdk/mobile/swift/.md) * [Objective-C](https://docs.connect.worldline-solutions.com/documentation/sdk/mobile/ios/.md) We also have reference implementations showing how to use these SDKs on [GitHub](https://github.com/worldline-global-collect) ### Non-encrypted data Use this option if you wish to do a direct server-to-server API call and handle the card data directly. The difference with the other options is that you don't need to submit an encryptedCustomerInputproperty. After the consumer selects the payment product, you need to perform the following: 1. Make a [POST /v1/{merchantId}/payments](https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/json/payments/create.html?paymentPlatform=ALL) 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 cvv, cardNumber, expiryDate, and cardholderName The cardholderName is often different from the name a customer uses when registering an account. The cardholderName refers to the official name the customer uses with their issuing bank. POST PAYMENTS REQUESTCopy { "order": { "amountOfMoney": { "amount": 1100, "currencyCode": "EUR" }, "customer": { "billingAddress": { "countryCode": "FR" } } }, "cardPaymentMethodSpecificInput": { "paymentProductId": 130, "card": { "cvv": "123", "cardNumber": "4111111111111111", "expiryDate": "1233", "cardholderName": "Foo Bar" } } } POST PAYMENTS RESPONSECopy { "creationOutput" : { "additionalReference" : "00000099921000053918", "externalReference" : "000000999210000539180000100001" }, "payment" : { "id" : "000000999210000539180000100001", "paymentOutput" : { "amountOfMoney" : { "amount" : 1100, "currencyCode" : "EUR" }, "references" : { "paymentReference" : "0", "providerId" : "999", "providerReference" : "12345678901212345612345678901" }, "paymentMethod" : "card", "cardPaymentMethodSpecificOutput" : { "paymentProductId" : 130, "authorisationCode" : "654321", "fraudResults" : { "fraudServiceResult" : "no-advice", "avsResult" : "0", "cvvResult" : "0" }, "card" : { "cardNumber" : "411111******1111", "cardholderName" : "Foo Bar", "expiryDate" : "1233" } } }, "status" : "CAPTURE_REQUESTED", "statusOutput" : { "isCancellable" : true, "isRetriable" : false, "statusCategory" : "PENDING_CONNECT_OR_3RD_PARTY", "statusCode" : 800, "statusCodeChangeDateTime" : "20240123135338", "isAuthorized" : true, "isRefundable" : false } } } [Next Process flows](https://docs.connect.worldline-solutions.com/payment-product/Cartes-bancaires/process-flows.md)