Creating a WhatsApp payment order
Use cases
The merchant creates a payment order sent by WhatsApp to the buyer.
Test
Test the Charge/CreatePaymentOrder Web Service via our playground: Charge/CreatePaymentOrder.
Request
Immediate payment
Sample query
Required fields:
- Amount: €100,00.
- Distribution channel: WHATSAPP.
- Numéro de téléphone de l'acheteur : "+33611111111"
. Recommended fields:
- Référence de la commande : "myOrderId-1234"
/en-EN/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44
https://api.lyra.com/api-payment/V4/Charge/CreatePaymentOrder
{
"amount": 10000,
"currency": "EUR",
"orderId": "myOrderId-1234",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber":"+33611111111"
}
}
} {
"amount": 200050,
"currency": "PEN",
"orderId": "myOrderId-999999",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber": "+51987654321"
}
},
"paymentReceiptEmail": "sample@example.com",
"expirationDate": "2020-04-20T20:13:26+02:00",
"locale": "es_PE",
"dataCollectionForm": "false"
} {
"amount": 200050,
"currency": "ARS",
"orderId": "myOrderId-999999",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber": "+5491112345678"
}
},
"paymentReceiptEmail": "sample@example.com",
"expirationDate": "2020-04-20T20:13:26+02:00",
"locale": "es_AR",
"dataCollectionForm": "false"
} {
"amount": 200050,
"currency": "COP",
"orderId": "myOrderId-999999",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber": "+573191234567"
}
},
"paymentReceiptEmail": "sample@example.com",
"expirationDate": "2020-04-20T20:13:26+02:00",
"locale": "es_CO",
"dataCollectionForm": "false"
} {
"amount": 200050,
"currency": "EUR",
"orderId": "myOrderId-999999",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber":"+5511123456789"
}
},
"paymentReceiptEmail": "sample@example.com",
"expirationDate": "2020-04-20T20:13:26+02:00",
"dataCollectionForm": "false"
} The description and all of the fields are available (menu on the left): Charge/CreatePaymentOrder.
Payment in installments
Prerequisites
- subject to option and/or depending on your offer
- not available for SEPA payments
Sample query
Champs obligatoires :- Amount: €100,00.
- Distribution channel: WHATSAPP.
- Numéro de téléphone de l'acheteur : "+33611111111"
- Rule: Payment in 3 installments. The first amount is €50,00 with an interval of 7 days.
. Recommended fields:
- Référence de la commande : "myOrderId-1234".
/en-EN/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44
https://api.lyra.com/api-payment/V4/Charge/CreatePaymentOrder
{
"amount": 10000,
"currency": "EUR",
"orderId": "myOrderId-1234",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber":"+33611111111"
}
},
"transactionOptions": {
"installmentOptions": {
"firstAmount": 5000,
"count": 3,
"period": 7
}
}
}Le premier paiement de 50,00 EUR est créé à J+0.
Le deuxième paiement de 25,00 EUR est créé à J+7.
Le troisième paiement de 25,00 EUR est créé à J+14.
The description and all of the fields are available (menu on the left): Charge/CreatePaymentOrder.
Pay in instalments with a personalized payment plan
Prerequisites
- subject to the "Advanced installment payment" option
- not taking into account the value of the Capture Delay field (time to bank)
- not available for SEPA payments
Sample query
Champs obligatoires :- Amount: €100,00.
- Distribution channel: WHATSAPP.
- Numéro de téléphone de l'acheteur : "+33611111111"
- Rule: Payment in 3 installments.
- April 1, 2023 for an amount of EUR 50,00.
- May 1, 2023 for an amount of EUR 30,00.
- June 1, 2023 for an amount of EUR 20,00.
. Recommended fields:
- Référence de la commande : "myOrderId-1234".
/en-EN/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44
https://api.lyra.com/api-payment/V4/Charge/CreatePaymentOrder
{
"amount": 10000,
"currency": "EUR",
"orderId": "myOrderId-1234",
"channelOptions": {
"channelType": "WHATSAPP",
"whatsAppOptions": {
"phoneNumber":"+33611111111"
}
},
"transactionOptions": {
"installmentOptions": {
"schedules": [
{
"date": "2023-04-01T23:59:59+00:00",
"amount": 5000
},
{
"date": "2023-05-01T23:59:59+00:00",
"amount": 3000
},
{
"date": "2023-06-01T23:59:59+00:00",
"amount": 2000
}
]
}
}
} Response
Example of a response
{
"webService": "Charge/CreatePaymentOrder",
"version": "V4",
"applicationVersion": "5.5.0",
"status": "SUCCESS",
"answer": {
"paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
"paymentURL": "https://secure.lyra.com/t/328zq5so",
"paymentOrderStatus": "RUNNING",
"creationDate": "2020-03-31T15:06:49+00:00",
"updateDate": null,
"amount": 10000,
"currency": "EUR",
"locale": "fr_FR",
"strongAuthentication": "AUTO",
"orderId": "myOrderId-1234",
"channelDetails": {
"channelType": "WHATSAPP",
"mailDetails": null,
"smsDetails": null,
"whatsAppDetails": {
"phoneNumber": "+3361111111",
"_type": "V4/WhatsAppDetails"
},
"ivrDetails": null,
"_type": "V4/ChannelDetails"
},
"paymentReceiptEmail": "sample@example.com",
"taxRate": null,
"taxAmount": null,
"expirationDate": "2020-04-20T18:13:26+00:00",
"transactionDetails": {
"cardDetails": {
"manualValidation": "NO",
"captureDelay": 0,
"_type": "V4/CardDetails"
},
"_type": "V4/PaymentOrderTransactionDetails"
},
"dataCollectionForm": false,
"merchantComment": null,
"message": "Bonjour, voici un ordre de paiement envoyé par DEMO STORE d'un montant de 2000.50 EUR valable jusqu'au 23/04/2020. Pour confirmer, veuillez suivre le lien : https://secure.lyra.com/t/xdt0bcmo",
"_type": "V4/PaymentOrder"
},
"ticket": null,
"serverDate": "2020-03-31T15:06:49+00:00",
"applicationProvider": "PAYZEN",
"metadata": null,
"_type": "V4/WebService/Response"
} {
"webService": "Charge/CreatePaymentOrder",
"version": "V4",
"applicationVersion": "5.5.0",
"status": "SUCCESS",
"answer": {
"paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
"paymentURL": "https://secure.lyra.com/t/328zq5so",
"paymentOrderStatus": "RUNNING",
"creationDate": "2020-03-31T15:06:49+00:00",
"updateDate": null,
"amount": 200050,
"currency": "EUR",
"locale": "en_GB",
"strongAuthentication": "AUTO",
"orderId": "myOrderId-999999",
"channelDetails": {
"channelType": "WHATSAPP",
"mailDetails": null,
"smsDetails": null,
"whatsAppDetails": {
"phoneNumber": "+51987654321",
"_type": "V4/WhatsAppDetails"
},
"ivrDetails": null,
"_type": "V4/ChannelDetails"
},
"paymentReceiptEmail": "sample@example.com",
"taxRate": null,
"taxAmount": null,
"expirationDate": "2020-04-20T18:13:26+00:00",
"transactionDetails": {
"cardDetails": {
"manualValidation": "NO",
"captureDelay": 0,
"_type": "V4/CardDetails"
},
"_type": "V4/PaymentOrderTransactionDetails"
},
"dataCollectionForm": false,
"merchantComment": null,
"message": Dear customer, this is a payment order sent by DEMO STORE of EUR 2,000.50 valid until 23/04/2020. To confirm, please click on the link below : https://secure.lyra.com/t/xdt0bcmo",
"_type": "V4/PaymentOrder"
},
"ticket": null,
"serverDate": "2020-03-31T15:06:49+00:00",
"applicationProvider": "PAYZEN",
"metadata": null,
"_type": "V4/WebService/Response"
}
} {
"webService": "Charge/CreatePaymentOrder",
"version": "V4",
"applicationVersion": "5.5.0",
"status": "SUCCESS",
"answer": {
"paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
"paymentURL": "https://secure.lyra.com/t/328zq5so",
"paymentOrderStatus": "RUNNING",
"creationDate": "2020-03-31T15:06:49+00:00",
"updateDate": null,
"amount": 200050,
"currency": "EUR",
"locale": "es_ES",
"strongAuthentication": "AUTO",
"orderId": "myOrderId-999999",
"channelDetails": {
"channelType": "WHATSAPP",
"mailDetails": null,
"smsDetails": null,
"whatsAppDetails": {
"phoneNumber": "+51987654321",
"_type": "V4/WhatsAppDetails"
},
"ivrDetails": null,
"_type": "V4/ChannelDetails"
},
"paymentReceiptEmail": "sample@example.com",
"taxRate": null,
"taxAmount": null,
"expirationDate": "2020-04-20T18:13:26+00:00",
"transactionDetails": {
"cardDetails": {
"manualValidation": "NO",
"captureDelay": 0,
"_type": "V4/CardDetails"
},
"_type": "V4/PaymentOrderTransactionDetails"
},
"dataCollectionForm": false,
"merchantComment": null,
"message": "Hola, este mensaje contiene una solicitud de pago enviada por DEMO STORE por un monto de 2.000,50 ARS, válida hasta el 23/04/2020. Para confirmar el pago, haga clic en el enlace siguiente : https://secure.lyra.com/t/xdt0bcmo",
"_type": "V4/PaymentOrder"
},
"ticket": null,
"serverDate": "2020-03-31T15:06:49+00:00",
"applicationProvider": "PAYZEN",
"metadata": null,
"_type": "V4/WebService/Response"
}
} {
"webService": "Charge/CreatePaymentOrder",
"version": "V4",
"applicationVersion": "5.5.0",
"status": "SUCCESS",
"answer": {
"paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
"paymentURL": "https://secure.lyra.com/t/328zq5so",
"paymentOrderStatus": "RUNNING",
"creationDate": "2020-03-31T15:06:49+00:00",
"updateDate": null,
"amount": 200050,
"currency": "EUR",
"locale": "es_ES",
"strongAuthentication": "AUTO",
"orderId": "myOrderId-999999",
"channelDetails": {
"channelType": "WHATSAPP",
"mailDetails": null,
"smsDetails": null,
"whatsAppDetails": {
"phoneNumber": "+573191234567",
"_type": "V4/WhatsAppDetails"
},
"ivrDetails": null,
"_type": "V4/ChannelDetails"
},
"paymentReceiptEmail": "sample@example.com",
"taxRate": null,
"taxAmount": null,
"expirationDate": "2020-04-20T18:13:26+00:00",
"transactionDetails": {
"cardDetails": {
"manualValidation": "NO",
"captureDelay": 0,
"_type": "V4/CardDetails"
},
"_type": "V4/PaymentOrderTransactionDetails"
},
"dataCollectionForm": false,
"merchantComment": null,
"message": "Hola, este mensaje contiene una solicitud de pago enviada por DEMO STORE por un monto de 2.000,50 COP, válida hasta el 23/04/2020. Para confirmar el pago, haga clic en el enlace siguiente : https://secure.lyra.com/t/xdt0bcmo",
"_type": "V4/PaymentOrder"
},
"ticket": null,
"serverDate": "2020-03-31T15:06:49+00:00",
"applicationProvider": "PAYZEN",
"metadata": null,
"_type": "V4/WebService/Response"
}
} {
"webService": "Charge/CreatePaymentOrder",
"version": "V4",
"applicationVersion": "5.5.0",
"status": "SUCCESS",
"answer": {
"paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
"paymentURL": "https://secure.lyra.com/t/328zq5so",
"paymentOrderStatus": "RUNNING",
"creationDate": "2020-03-31T15:06:49+00:00",
"updateDate": null,
"amount": 200050,
"currency": "EUR",
"locale": "es_ES",
"strongAuthentication": "AUTO",
"orderId": "myOrderId-999999",
"channelDetails": {
"channelType": "WHATSAPP",
"mailDetails": null,
"smsDetails": null,
"whatsAppDetails": {
"phoneNumber": "+5491112345678",
"_type": "V4/WhatsAppDetails"
},
"ivrDetails": null,
"_type": "V4/ChannelDetails"
},
"paymentReceiptEmail": "sample@example.com",
"taxRate": null,
"taxAmount": null,
"expirationDate": "2020-04-20T18:13:26+00:00",
"transactionDetails": {
"cardDetails": {
"manualValidation": "NO",
"captureDelay": 0,
"_type": "V4/CardDetails"
},
"_type": "V4/PaymentOrderTransactionDetails"
},
"dataCollectionForm": false,
"merchantComment": null,
"message": "Hola, este mensaje contiene una solicitud de pago por un importe de 2.000,50 PEN, válida hasta el 23/04/2020. Para confirmar el pago, haga clic en el enlace siguiente : https://secure.lyra.com/t/xdt0bcmo",
"_type": "V4/PaymentOrder"
},
"ticket": null,
"serverDate": "2020-03-31T15:06:49+00:00",
"applicationProvider": "PAYZEN",
"metadata": null,
"_type": "V4/WebService/Response"
}
} {
"webService": "Charge/CreatePaymentOrder",
"version": "V4",
"applicationVersion": "5.5.0",
"status": "SUCCESS",
"answer": {
"paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
"paymentURL": "https://secure.lyra.com/t/328zq5so",
"paymentOrderStatus": "RUNNING",
"creationDate": "2020-03-31T15:06:49+00:00",
"updateDate": null,
"amount": 200050,
"currency": "EUR",
"locale": "pt_BR",
"strongAuthentication": "AUTO",
"orderId": "myOrderId-999999",
"channelDetails": {
"channelType": "WHATSAPP",
"mailDetails": null,
"smsDetails": null,
"whatsAppDetails": {
"phoneNumber": "+5511123456789",
"_type": "V4/WhatsAppDetails"
},
"ivrDetails": null,
"_type": "V4/ChannelDetails"
},
"paymentReceiptEmail": "sample@example.com",
"taxRate": null,
"taxAmount": null,
"expirationDate": "2020-04-20T18:13:26+00:00",
"transactionDetails": {
"cardDetails": {
"manualValidation": "NO",
"captureDelay": 0,
"_type": "V4/CardDetails"
},
"_type": "V4/PaymentOrderTransactionDetails"
},
"dataCollectionForm": false,
"merchantComment": null,
"message": "Caro cliente, este mensagem contém uma ordem de pagamento enviada por DEMO STORE no valor de 2000.50 BRL válida até 23/04/2020. Para confirmar o pagamento, favor clicar sobre o link seguinte : https://secure.lyra.com/t/xdt0bcmo",
"_type": "V4/PaymentOrder"
},
"ticket": null,
"serverDate": "2020-03-31T15:06:49+00:00",
"applicationProvider": "PAYZEN",
"metadata": null,
"_type": "V4/WebService/Response"
}The payment order is sent to the Buyer as a WhatsApp message.
View the description and all the fields in our playground:PaymentOrder
Error handling
Error table
| Code | Description |
|---|---|
| INT_009 | The format of the amount field is invalid or the field is not transmitted. |
| INT_010 | The format of the currency field is invalid or the field is not transmitted. |
| INT_050 | The strongAuthentication parameter is invalid. |
| INT_856 | The locale parameter is invalid. |
| INT_858 | The taxRate parameter is invalid. |
| INT_869 | The taxAmount parameter is invalid. |
| INT_929 | The installmentOptions.count parameter is invalid. |
| INT_930 | The installmentOptions.period parameter is invalid. |
| INT_931 | The installmentOptions.schedules[] parameter is invalid. |
| INT_932 | The installmentOptions.schedules[date] parameter is invalid. |
| INT_933 | The format of the installmentOptions.schedules[amount] field is invalid or the field is not transmitted. |
| PSP_519 | Unknown currency. |
| PSP_606 | Currency not supported by the MID. |
| PSP_1007 | The expiry date of the payment order cannot be earlier than the current date or exceed 90 days. |
| PSP_1015 | No data collection form for this shop. |
| PSP_1018 | The data collection form cannot be used for the requested currency. |
Analysis of payment results
To see the payment result, implement the instant payment notification (also known as IPN).
