Phone-Moto

This confirmation strategy is similar to Email-Moto strategy, but it targets to confirm the consumer’s phone number through an sms message inside of a MOTO (mail order/telephone order) environment. There will be an intermediary step where the consumer must agree with a disclaimer before finishing the confirmation process. SMS message templates shall be interpreted as plain-text messages, so HTML tags won’t be rendered correctly. URLs in the SMS body are usually transformed in clickable links by the mobile device itself.

It worths to say that all the links received in the SMS-based processes are shortened with our safe and proprietary url-shortener service (links are rendered as https://pcer.co/{UNIQUE_TOKEN}).

To trigger a new confirmation process, you must make an authenticated request by using the following URL.

POST https://confirmation-api.paycertify.com/api/confirmations

Parameter Type Description Example  
confirmation_template_id uuid The template ID 63693de5-8a19-4233-b382-c75f0c6b31aa  
phone_number string Status of this template [email protected]  
timeout_seconds string Time 90  
callback_url string Url 90  
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 template 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, confirmation.refused, failed, expired processing
confirmation.callback_url string The provided callback URL http://hooks.my.com/paycertify
confirmation.process.id uuid Process-specific ID baa88e8a-300a-4833-b716-48f85251b832
confirmation.process.state string Process-specific state. The states available are idle, generating_token, sending_sms, waiting_token, waiting_agreement, finished, failed sending_sms
confirmation.phone_number string The user’s phone number that you want to confirm (in E.164 format) +11231231234
confirmation.process.timeout_seconds string Time in seconds 60
confirmation.process.fail_reason string Status of this template  
confirmation.process.created_at datetime Status of this template 2018-07-05T14:09:40.106Z
confirmation.process.updated_at datetime Status of this template 2018-07-05T14:09:40.106Z
confirmation.confirmation_actions.*.id uuid Status of this template  
confirmation.confirmation_actions.*.created_at datetime Status of this template 2018-07-05T14:09:40.106Z
confirmation.confirmation_actions.*.action_name string Status of this template  
confirmation.confirmation_actions.*.actor string Status of this template  
confirmation.confirmation_actions.*.executed string Status of this template  
confirmation.confirmation_actions.*.error_message string Status of this template  
curl --request POST \
  --url 'https://confirmation-api.paycertify.com/api/confirmations' \
  --header 'Authorization: Bearer D28A17DFD326A2E255DC4C69C17C2451446A7EC8' \
  --header 'Cache-Control: no-cache' \
  --form 'confirmation_template_id=54dadf8b-b4f3-4b47-87e9-a4a1b48e59bd' \
  --form 'phone_number=+11231231234' \
  --form 'timeout_seconds=540' \
  --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": "29fce109-0fdd-4c54-a1c0-62d02d799d94",
    "created_at": "2018-07-05T15:09:21.391Z",
    "updated_at": "2018-07-05T15:09:21.400Z",
    "state": "processing",
    "callback_url": null,
    "process_name": "phone_moto",
    "process": {
        "id": "94cc2188-16f2-4f85-883f-44902a26262f",
        "state": "waiting_token",
        "phone_number": "+11231231234",
        "timeout_seconds": 540,
        "fail_reason": null,
        "merchant_id": "48a872f9-9389-4047-be85-a38d291e62b3",
        "created_at": "2018-07-05T15:09:21.386Z",
        "updated_at": "2018-07-05T15:09:23.905Z",
        "amount": "3.56",
        "order_description": "Hand pruners And loppers",
        "first_name": "Arthur",
        "last_name": "Tofani",
        "full_name": "Arthur Tofani",
        "threeds_eci": null,
        "threeds_cavv": null,
        "threeds_xid": null,
        "threeds_status": null
    },
    "confirmation_actions": [
        {
            "id": "75f8985b-4f70-4c20-baba-9fcc07fcc481",
            "created_at": "2018-07-05T15:09:21.397Z",
            "action_name": "start",
            "actor": "merchant",
            "executed": null,
            "error_message": null
        }
    ]
  }
}