Showing Confirmations

Under your Fraud Portal account settings, you can define a postback URL to receive fraud data as a POST to perform any sort of automated rules that your business logic requires. These postbacks happen whenever a new transaction is created through the API.

GET https://confirmation-api.paycertify.com/api/confirmations/{confirmation_id}

Field	Type	Description	Example
`id`	`uuid`	The confirmation ID	baa88e8a-300a-4833-b716-48f85251b839
`created_at`	`datetime`	Created at date/time	2018-05-12T21:07:59.508Z
`updated_at`	`datetime`	Updated at date/time	2018-05-12T21:07:59.508Z
`state`	`string`	Status of this confirmation request. The possible states are: `idle`, `processing`, `confirmed`, `refused`, `failed`, `expired`	processing
`callback_url`	`string`	The provided callback URL	http://hooks.my.com/paycertify
`process_name`	`string`	The selected process strategy name	email_ecommerce
`process.id`	`uuid`	Process-specific ID	baa88e8a-300a-4833-b716-48f85251b832
`process.state`	`string`	Process-specific state.	waiting_response
`process.email_address`	`string`	Email	[email protected]
`process.timeout_seconds`	`string`	Time in seconds	300
`process.fail_reason`	`string`	A fail description when process fails	Delivery Error
`process.created_at`	`datetime`	Process-specific created at date	2018-07-05T14:09:40.106Z
`process.updated_at`	`datetime`	Process-specific updated at date	2018-07-05T14:09:40.106Z
`confirmation_actions.*.id`	`uuid`	Action ID	ce388e8a-300a-4833-b716-48f85251b839
`confirmation_actions.*.created_at`	`datetime`	Action created at date	2018-07-05T14:09:40.106Z
`confirmation_actions.*.action_name`	`string`	Action name	start
`confirmation_actions.*.actor`	`string`	Action’s actor	merchant
`confirmation_actions.*.executed`	`string`	If action is executed or not	true
`confirmation_actions.*.error_message`	`string`	Error message	Delivery Error

curl --request GET \
  --url 'https://confirmation-api.paycertify.com/api/confirmations/baa88e8a-300a-4833-b716-48f85251b839' \
  --header 'Authorization: Bearer D28A17DFD326A2E255DC4C69C17C2451446A7EC8' \

Responds with:

{
    "id": "3c86e137-1e59-4af5-bf9d-8f6b2970d4f9",
    "created_at": "2018-07-05T14:55:36.171Z",
    "updated_at": "2018-07-05T15:04:15.043Z",
    "state": "confirmed",
    "callback_url": null,
    "process_name": "phone_ecommerce",
    "process": {
        "id": "e8ef69e8-c50d-41ce-b306-a281217cb024",
        "state": "finished",
        "phone_number": "+5531992274225",
        "timeout_seconds": 540,
        "fail_reason": null,
        "user_response": "confirm",
        "token": "176cca1822cd0f3a23732fdbbb0ed62deefdbdd3",
        "nonce": "36615003",
        "merchant_id": "48a872f9-9389-4047-be85-a38d291e62b3",
        "created_at": "2018-07-05T14:55:36.165Z",
        "updated_at": "2018-07-05T15:04:15.038Z"
    },
    "confirmation_actions": [
        {
            "id": "152283ba-3959-4871-8f87-2a246995c17f",
            "created_at": "2018-07-05T14:55:36.179Z",
            "action_name": "start",
            "actor": "merchant",
            "parameters": {
                "phone_number": "+5531992274225",
                "timeout_seconds": "540"
            },
            "executed": null,
            "error_message": null
        },
        {
            "id": "a1c8bd51-84b6-4f5b-a467-69f9268d9300",
            "created_at": "2018-07-05T15:04:15.030Z",
            "action_name": "confirm",
            "actor": "user",
            "parameters": {
                "id": "e8ef69e8-c50d-41ce-b306-a281217cb024",
                "token": "176cca1822cd0f3a23732fdbbb0ed62deefdbdd3",
                "action_name": "confirm"
            },
            "executed": null,
            "error_message": null
        }
    ]
}