Noda Live

This integration option supports the following operations:

Payment

Request

Send a payment request with the following additional parameters:

Parameter	Type	Description
method	object	A section of the payment method information.
type * required	string	`noda_live`
customer	object	A section of the customer information.
device_id * required	string	The customer's ID in the merchant's system.
email * required	string	The customer's email.

Response

The payment response additionally contains the form section. Redirect your customer to the URL received as a value of the form.action parameter, so he/ she can complete the payment.

Info

The link to complete the payment is valid for 60 minutes only.

Request example

        ~~~json
        {
        "request":{
                "amount": 6500,
                "currency":"EUR",
                "description":"description",
                "test": true,
                "tracking_id":"your_unique_number",
                "ip":"127.0.0.1",
                "language":"en",
                "notification_url":"https://your-notification-url.com",
                "return_url":"https://your-return-url.com",
                "customer":{
                        "device_id":"123456987",
                        "email": "your-suctomer-email@test.com"
                },
                "method":{
                        "type": "noda_live"
                }
                }
        }
        ~~~

Response example. HTTP code 200

~~~json
{
"transaction": {
        "uid": "9f6a8e75-6ee4-4d6f-8173-30d8ef84d181",
        "type": "payment",
        "status": "pending",
        "amount": 6500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2023-03-02T17:46:56Z",
        "updated_at": "2023-03-02T17:47:00Z",
        "method_type": "noda_live",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/9f6a8e75-6ee4-4d6f-8173-30d8ef84d181/9297cb1f10380a119a4cbe0951c4e8c2eb1480fa40573ecf932ac9d761ff8722?language=en",
        "payment": {
                "status": "pending",
                "gateway_id": 2478,
                "ref_id": "898a79f5-b2fe-4ad6-aa2d-5bfb0b427dcd",
                "message": "Transaction was initialized"
        },
        "noda_live": {
                "type": "noda_live"
        },
        "customer": {
                "email": "your-customer-email@gmail.com",
                "device_id": "123456987",
                "ip": "127.0.0.1"
        },
        "message": "Transaction was initialized",
        "tracking_id": "your_unique_number",
        "test": true,
        "language": "en",
        "billing_address": {
                "email": "your-customer-email@gmail.com",
                "device_id": "123456987"
        },
        "additional_data": {
                "payment_method": {
                "type": "alternative"
                }
        },
        "gateway": {
                "iframe": true
        },
        "form": {
                "action": "https://stage.checkout.noda.live/?id=898a79f5-b2fe-4ad6-aa2d-5bfb0b427dcd&token=v4.local.yydoQfpRntm-mddZ4Ijdv7hhBCOALPwJ9BESkfaVubbAMqRU_YJdP3Nl1qZXWdIZ6Sp-06DsakUWPQfF4Uxd7_A1BCjcm0MLYkHmTbflF5ZVzxa-1wFYrDFU63kDGekpkSEhU27GffG6TV1ZTa9-OcCeIELlaouEzlFrng6FuKiQMUaqFLRjh5uIsNmNxFdQLqbd9auW15Z6O1FuGlAIyp1SClKQybsOqVVuE6zu5h09Ssggqvlk1n6DHK42IIXZzFM9qGYHc16t1oly1C7iVB5XUOL3W7HK0UCPZtJUesRji-Wo8U5S9YOiwNnFj4D8LEtOTVHV6thDzfDwoDPN910&country=FR&returnUrl=https%3a%2f%2fhttps://api.paysage.io%2fbeyag%2ftransactions%2freturns%2f116c3a35b6189260f458410f2b04eb2fbc3633d24b4b9353ece75cc73c6e9f29%2f9f6a8e75-6ee4-4d6f-8173-30d8ef84d181&providerId=max_fr&type=processing&info_isNew=true",
                "method": "GET",
                "fields": []
        }
}
}
~~~

Payout

Request

Send a payout request with the following additional parameters:

Parameter	Type	Description
method	object	A section of the payment method information.
type * required	string	`noda_live`
account * required	string	An International Bank Account Number (IBAN) of the payout recipient.
customer	object	A section of the customer information.
first_name * required	string	The customer's first name.
last_name * required	string	The customer's last name.

Response

The payout response additionally contains the noda_live section with the parameters submitted in the request.

Request example

~~~json
{
"request":{
        "amount": 400,
        "currency":"EUR",
        "description":"description",
        "test": true,
        "tracking_id":"your_unique_number",
        "ip":"127.0.0.1",
        "language":"en",
        "notification_url":"https://api.paysage.io/beyag/transactions/notifications/noda_live",
        "return_url":"https://your-success.url",
        "customer":{
                "first_name":"John",
                "last_name":"Doe"
        },
        "method":{
                "type": "noda_live",
                "account": "GB33BUKB20211555555234"
        }
}
}
~~~

Response example. HTTP code 200

~~~json
{
"transaction": {
        "uid": "e13fb4cc-d505-4cbc-bfd2-04835650afcc",
        "type": "payout",
        "status": "successful",
        "amount": 400,
        "currency": "EUR",
        "description": "description",
        "created_at": "2023-03-02T18:21:14Z",
        "updated_at": "2023-03-02T18:21:19Z",
        "method_type": "noda_live",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/e13fb4cc-d505-4cbc-bfd2-04835650afcc/94fe6c1f7e8d4d169ae41fb76725f0cfb0d6ca75a8656badb891beea12f0ab4f?language=en",
        "payout": {
                "status": "successful",
                "gateway_id": 2478,
                "ref_id": "f89fc0457652446db6d6aadf096c5290",
                "message": "Transaction was successfully processed"
        },
        "noda_live": {
                "type": "noda_live",
                "account": "GB33BUKB20211555555234"
        },
        "customer": {
                "email": null,
                "ip": "127.0.0.1"
        },
        "message": "Transaction was successfully processed",
        "tracking_id": "your_unique_number",
        "test": true,
        "language": "en",
        "paid_at": "2023-03-02T18:21:19+00:00",
        "billing_address": {
                "first_name": "John",
                "last_name": "Doe"
        },
        "additional_data": {
        "payment_method": {
                "type": "alternative"
        }
        }
}
}
~~~

Status query

Request

If you specify notification_url in the payment or payout request, PaySage.io sends a webhook notification about a transaction status. Please note, it might take some time for PaySage.io to get the transaction status confirmation from the payment method provider.

If needed, send a status query request to get the current transaction status.

Response

The response contains the transaction status, a section of the payment method as well as other details related to the transaction according to the description of a transaction status query.