Email-MOTO-Secure
This strategy works similarly to the Email-MOTO strategy but includes 3D-Secure verification in its pipeline. This process requires the consumer to confirm credit card and order details and agree with the disclaimer before proceeding. After submitting its agreement and confirm the transaction, the API response will additionally receive the results for the 3D-Secure process with verdict.
To trigger an Email-MOTO-Secure confirmation process, you must make an authenticated request by using the following URL.
POST https://confirmation-api.paycertify.com/api/confirmations
Parameter | Type | Presence | Description | Example |
---|---|---|---|---|
confirmation_template_id |
uuid |
Required | A template ID that relates to this confirmation strategy. | 63693de5-8a19-4233-b382-c75f0c6b31aa |
email_address |
string |
Required | The user’s email that you want to confirm | [email protected] |
timeout_seconds |
string |
Optional | Timeout in seconds (default 60 seconds) | 90 |
callback_url |
string |
Optional | The callback URL | http://hooks.my.com/paycertify |
card_number |
string |
Required | The credit card to charge | 411111111111111 |
card_expiry_month |
string |
Required | The expiration month with two positions | 01 |
card_expiry_year |
string |
Required | The expiration year with four positions | 2021 |
amount |
string |
Required | Total transaction amount | 3.56 |
order_description |
string |
Required | A brief description of the current order | Hand pruners And loppers |
first_name |
string |
Required | Customer’s first name | John |
last_name |
string |
Required | Customer’s last name | Doe |
Field | Type | Description | Example |
---|---|---|---|
confirmation.id |
uuid |
The confirmation ID | baa88e8a-300a-4833-b716-48f85251b839 |
confirmation.created_at |
datetime |
Created at date/time | 2018-05-12T21:07:59.508Z |
confirmation.updated_at |
datetime |
Updated at date/time | 2018-05-12T21:07:59.508Z |
confirmation.state |
string |
Status of this confirmation request. States available are idle , processing , confirmed , refused , failed , expired |
processing |
confirmation.callback_url |
string |
The provided callback URL | http://hooks.my.com/paycertify |
confirmation.process_name |
string |
The selected process strategy name | email_moto_secure |
confirmation.process.id |
uuid |
Process-specific ID | baa88e8a-300a-4833-b716-48f85251b832 |
confirmation.process.state |
string |
Process-specific state. States available are: idle , generating_token , sending_email , waiting_click , waiting_agreement , finished , failed |
waiting_click |
confirmation.process.email_address |
string |
[email protected] | |
confirmation.process.timeout_seconds |
string |
Time in seconds | 60 |
confirmation.process.fail_reason |
string |
A fail description when process fails | Delivery Error |
confirmation.process.created_at |
datetime |
Process-specific created at date | 2018-07-05T14:09:40.106Z |
confirmation.process.updated_at |
datetime |
Process-specific updated at date | 2018-07-05T14:09:40.106Z |
confirmation.process.card_number |
string |
Masked card number | 411111**1111 |
confirmation.process.amount |
number |
Amount | 3.56 |
confirmation.process.order_description |
string |
Order description | Hand pruners and loopers |
confirmation.process.first_name |
string |
First name | Arthur |
confirmation.process.last_name |
string |
Last name | Tofani |
confirmation.process.full_name |
string |
Full name | Arthur Tofani |
confirmation.process.threeds_eci |
string |
3DS ECI | 05 |
confirmation.process.threeds_cavv |
string |
3DS CAVV | BwAQCXdVFgEAABUEYlUWEDw2I6M |
confirmation.process.threeds_xid |
string |
3DS XID | ICAgICAgICAgIDE1MDQ2MjU1MTM= |
confirmation.process.threeds_status |
string |
3DS Status | Y |
confirmation.confirmation_actions.*.id |
uuid |
Action ID | ce388e8a-300a-4833-b716-48f85251b839 |
confirmation.confirmation_actions.*.created_at |
datetime |
Action created at date | 2018-07-05T14:09:40.106Z |
confirmation.confirmation_actions.*.action_name |
string |
Action name | start |
confirmation.confirmation_actions.*.actor |
string |
Action’s actor | merchant |
confirmation.confirmation_actions.*.executed |
string |
If action is executed or not | true |
confirmation.confirmation_actions.*.error_message |
string |
Error message | Delivery Error |
curl --request POST \
--url 'https://confirmation-api.paycertify.com/api/confirmations' \
--header 'Authorization: Bearer D28A17DFD326A2E255DC4C69C17C2451446A7EC8' \
--header 'Cache-Control: no-cache' \
--form 'confirmation_template_id=15be8861-597a-4b7b-a0aa-b7486ba3de7e' \
--form 'timeout_seconds=600' \
--form '[email protected]' \
--form 'card_number=411111111111111' \
--form 'card_expiry_month=01' \
--form 'card_expiry_year=2021' \
--form 'amount=3.56' \
--form 'order_description=Hand pruners And loppers' \
--form 'first_name=John' \
--form 'last_name=Doe' \
Responds with:
{
"confirmation": {
"id": "ca8d77c9-4477-4f48-bbea-9bc52264e74d",
"created_at": "2018-07-05T14:09:40.098Z",
"updated_at": "2018-07-05T14:09:40.110Z",
"state": "processing",
"callback_url": null,
"process_name": "email_moto_secure",
"process": {
"id": "df3a192a-33d2-4d98-8e2d-29709c73e840",
"state": "waiting_click",
"email_address": "[email protected]",
"timeout_seconds": 600,
"fail_reason": null,
"created_at": "2018-07-05T14:09:40.092Z",
"updated_at": "2018-07-05T14:09:40.137Z",
"card_number": "411111******1111",
"amount": "3.56",
"order_description": "Hand pruners And loppers",
"first_name": "Arthur",
"last_name": "Tofani",
"full_name": "Arthur Tofani",
"threeds_eci": "05",
"threeds_cavv": "BwAQCXdVFgEAABUEYlUWEDw2I6M",
"threeds_xid": "ICAgICAgICAgIDE1MDQ2MjU1MTM",
"threeds_status": "Y"
},
"confirmation_actions": [
{
"id": "d198c09a-6713-4fa3-ba75-187a409bf2b5",
"created_at": "2018-07-05T14:09:40.106Z",
"action_name": "start",
"actor": "merchant",
"executed": null,
"error_message": null
}
]
}
}