Cpay

Countries & currencies

Supported countries

• France

Supported currencies

• Euro (EUR)

Integration

Process transactions via our Hosted Checkout Page. Find a high level overview in the "Process flows" chapter.

Add the following properties to a standard CreateHostedCheckout request:

{
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 12000
    },
    "customer": {
      "billingAddress": {
        "countryCode": "FR"
      },
      "contactDetails": {
        "emailAddress": "customer@merchant.com"
      }
    },
    "references": {
      "merchantOrderId": "123456787",
      "merchantReference": "",
      "descriptor": "COM/DESC"
    }
  },
  "hostedCheckoutSpecificInput": {
    "locale": "fr_FR",
    "returnUrl": "https://www.merchant.com",
    "showResultPage": "true"
  },
  "cardPaymentMethodSpecificInput": {
    "requiresApproval": true,
    "skipAuthentication": false,
    "paymentProduct5100SpecificInput": {
      "brand": "CREDIT IN 5 MONTHS"
    }
  }
}

Process flows

1. Your customers finalise an order in your shop and select Cpay.
2. You send this CreateHostedCheckout request to our platform.
3. You redirect your customers via the redirectUrl. Your customers enter their credit card number and select a modality. Depending on your customers’ choice, two scenarios are possible:
   3'. (optional) Credit/Debit: We might redirect the customer to her/his issuing bank for 3-D Secure authentication. If the identification was successful, the flow continues at step 5. If the identification was unsuccessful, we redirect your customers to your returnUrl, ending the flow.
   3’’. (optional) Instalment: You customers are redirected to a new page on which we show the financial conditions. If they accept, the flow continues at step 5. If not, we redirect your customers to your returnUrl, ending the flow.
4. We submit the actual financial transaction to the acquirer to process it. We receive the transaction result.
5. We redirect your customer to your returnUrl
6. You request the transaction result from our platform via GetHostedCheckout or receive the result via webhooks.
7. If the transaction was successful, you can deliver the goods / services.

Testing

Refer to our Test cases for test data and detailed instructions.

Additional information

Available features

List of modalities

As described in our payment methods specifics chapter, BNP PF offers a extensive range of different modalities. Please contact BNP PF to make them available for your customers!