Automatically generated urls

There is a functionality that allows us to receive the payment urls in the order generation response when generating a new order.

Example of response:

{
    "message": "OK",
    "code": 200,
    "current_time": "2023-01-19T16:24:27+0100",
    "order": {
        "uuid": "A1C91A5A-5D0B-4F02-9C0A-E94B0984F775",
        "created": "2023-01-19T16:24:27+0100",
        "created_from_client_timezone": "2023-01-19T16:24:27+0100",
        "amount": 1,
        "currency": "978",
        "paid": false,
        "status": "CREATED",
        "safe": true,
        "refunded": 0,
        "additional": "",
        "service": "REDSYSPSD2",
        "service_uuid": "F9D76AE8-DDBB-4F17-8074-C2DABEE0A919",
        "customer": "008fc337-6f63-499c-bfff-dae376bd4e8a",
        "cof_txnid": null,
        "transactions": [],
        "token": "927b226343428bd1589ebce27c613cac862cf07c4a95dab259fa7e67c900f259bdae189adb4a827f3dc46c45665b77e1abe4a2adefbb3616ec9c81b3eaa2044b",
        "ip": null,
        "urls": {
            "payment_card": "https:\/\/api.paylands.com\/v1\/sandbox\/payment\/process\/927b226343428bd1589ebce27c613cac862cf07c4a95dab259fa7e67c900f259bdae189adb4a827f3dc46c45665b77e1abe4a2adefbb3616ec9c81b3eaa2044b",
            "bizum": "https:\/\/api.paylands.com\/v1\/sandbox\/payment\/bizum\/927b226343428bd1589ebce27c613cac862cf07c4a95dab259fa7e67c900f259bdae189adb4a827f3dc46c45665b77e1abe4a2adefbb3616ec9c81b3eaa2044b",
            "3ds_tokenized": "https:\/\/api.paylands.com\/v1\/sandbox\/payment\/tokenized\/927b226343428bd1589ebce27c613cac862cf07c4a95dab259fa7e67c900f259bdae189adb4a827f3dc46c45665b77e1abe4a2adefbb3616ec9c81b3eaa2044b"
        },
        "reference": null,
        "dynamic_descriptor": null,
        "threeds_data": null
    },
    "client": {
        "uuid": "42B8CF56-A7D7-4D4A-8349-4E27263CB2D5"
    },
    "validation_hash": "82fab7c792e645c11a83027255acb444c8768f4551e08dcf103a81fe491687db"
}

To activate it we must go to the Paylands left sidebar and click on Administration > Clients section. Once here we must access the details of the client where we want to enable the urls in the configuration preferences tab.

Here we will activate Generate payment urls and Generate shortened urls if we want a shortened version of the urls. It is important to note that the first option must be enabled if we want to receive the urls in an abbreviated form.

Example of shortened urls:

{
    "message": "OK",
    "code": 200,
    "current_time": "2023-01-19T17:16:22+0100",
    "order": {
        "uuid": "C7CD819E-4753-4B17-BF8C-BFD475F494E9",
        "created": "2023-01-19T17:16:21+0100",
        "created_from_client_timezone": "2023-01-19T17:16:21+0100",
        "amount": 1,
        "currency": "978",
        "paid": false,
        "status": "CREATED",
        "safe": true,
        "refunded": 0,
        "additional": "",
        "service": "REDSYSPSD2",
        "service_uuid": "F9D76AE8-DDBB-4F17-8074-C2DABEE0A919",
        "customer": "008fc337-6f63-499c-bfff-dae376bd4e8a",
        "cof_txnid": null,
        "transactions": [],
        "token": "60923aea7b42aab34a3869057db010706ee17bac7821236afc4ec61312bc290299281cf3a1cf847f22e2c3e86b939d265fe8b1b28587fece1b17f9952a8fcde9",
        "ip": null,
        "urls": {
            "payment_card": "https:\/\/api.paylands.com\/su\/tOIZRL7BhmEp",
            "bizum": "https:\/\/api.paylands.com\/su\/eHXolAqXtK4s",
            "3ds_tokenized": "https:\/\/api.paylands.com\/su\/141nZR9MJfgQ"
        },
        "reference": null,
        "dynamic_descriptor": null,
        "threeds_data": null
    },
    "client": {
        "uuid": "42B8CF56-A7D7-4D4A-8349-4E27263CB2D5"
    },
    "validation_hash": "cc8f74563d6f4a976e5721147abefeadae8c300f0c5055dae2410f6345d1c910"
}

URL Generation:

These three urls are generated automatically but in the case of bizum and 3ds tokenized certain requirements must be met.

Bizum: This url will only be generated if the provided service_uuid supports this payment method. Bizum

3ds_tokenized: This url will be returned if secure: true and source_uuid are provided in the request. 3Ds tokenized