• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
docs.
France
Spain
Europe (English)
India
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

One-click payment

This mode allows you to create a transaction from an alias. Thanks to the alias, the buyer does not need to re-enter their bank card number.

Prerequisites: create a token

  • For more information: Token creation.

Using a token

Request

Sample query

Required fields:

  • amount : 9.90 €.

  • alias : champ ,paymentMethodToken,= " b6e51ba31f934ac5b25ccad2a52ccd56,".

/en-EN/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.token.usage.php#L9-L44
https://api.lyra.com/api-payment/V4/Charge/CreatePayment
    {
        "amount": 990,
        "currency": "EUR",
        "paymentMethodToken": "b6e51ba31f934ac5b25ccad2a52ccd56"
    }
    /**
 * I initialize the PHP SDK
 */
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/keys.php';
require_once __DIR__ . '/helpers.php';

/** 
 * Initialize the SDK 
 * see keys.php
 */
$client = new Lyra\Client();

/**
 * create a transaction with a payment method token
 */
$store = array(
  "amount" => 250, 
  "currency" => "EUR",
  "paymentMethodToken" => "b6e51ba31f934ac5b25ccad2a52ccd56"
);

/**
 * do the web-service call
 */
$response = $client->post("V4/Charge/CreatePayment", $store);

/* I check if there are some errors */
if ($response['status'] != 'SUCCESS') {
    /* an error occurs, I throw an exception */
    display_error($response);
    $error = $response['answer'];
    throw new Exception("error " . $error['errorCode'] . ": " . $error['errorMessage'] );
}

?>

Response

Récupèrez le formToken pour afficher le formulaire de paiement (Plus d'infos : Afficher le formulaire).

Analysez le résultat du paiement (Plus d'infos : Analyser le résultat du paiement).

Example of a response

  {
    "shopId": "123456",
    "orderCycle": "CLOSED",
    "orderStatus": "PAID",
    "serverDate": "2023-10-20T13:53:41+00:00",
    (...)
      "_type": "V4/OrderDetails"
    },
(...)
    "transactions": [
      {
        "shopId": "123456",
        "uuid": "b72e91826ce14bfd802249d16eb30849",
        "amount": 990,
        "currency": "EUR",
        "paymentMethodType": "CARD",
        "paymentMethodToken": "b6e51ba31f934ac5b25ccad2a52ccd56",
        "status": "PAID",
        "detailedStatus": "AUTHORISED",
        "operationType": "DEBIT",
        "effectiveStrongAuthentication": "DISABLED",
       (...)
    "_type": "V4/Payment"
  }

For full details and descriptions of the fields, see the playground: answer/Payment.

Jobs
Legal
GDPR
25.18-1.11