Community Forum

Ask a Question

Beneficiary bank / payment details definition

Hi, Is there documentation about the bank details that can be added to a beneficiary? Thanks
ANSWERED

Payment method added lifecycle hook.

Hi there, We need to trigger a custom notification when an external payment method is added to a policy. From the documentation I cannot see if there is a lifecycle hook for payment methods added. I do see there is an event `payment_method_added_event`. Is it possible to hook into this event in the in the Product module code?
ANSWERED

number component bug

I've defined a component like this: ``` { "type": "number", "key": "alternative_mobile_number", "outputPath": "alternative_mobile_number", "label": "Alternative mobile number 2*", "validators": [ { "validation": { "min": 609999999, "type": "greaterThanNumber" } }, { "validation": { "max": 860000000, "type": "lessThanNumber" } } ], "props": { "prefix": "0", "colWidth": 6 } }, ``` When entering a 0 as the first digit I get redirected to a error page immediately: ![](https://files.readme.io/f295074-image.png) Thanks. FYI: This was an attempt to build a cellphone number validation. As per my other forum post, support for that would help a lot.
ANSWERED

Custom messages on component validators

Is it possible to set a custom message for a validator on a component? Something like: \` { "key": "some_field", "type": "text", "label": "Some Field", "validators": [ { "validation": { "type": "required", "message": "Please enter this value as it is of utmost importance!!!" } } ] } \` If yes, is there documentation for this? Joi validation when the whole page is submitted is a bit clunky for large pages. Thanks
ANSWERED

Google address inputs

Hi, I see from older release notes (<https://docs.rootplatform.com/changelog/root-release-update-january-2022#google-places-autocomplete-for-address-input>) and on the roadmap (<https://portal.productboard.com/root-platform/1-product-roadmap/c/33-google-places-autocomplete-for-capturing-addresses>) the Root supports capturing an address using google integration. 1. Can we get a demo of how this works potentially? 2. What are the costs involved to enable and run this feature? 3. Is there any documentation available for this feature? Thanks
ANSWERED

Cellphone number style input on application workflow schema

Hi, I'm trying to add a cellphone-style input to the application workflow schema but the available validation and component types don't seem to allow for a component that ends up looking like the ones we see on the policyholder page. See below from the policyholder page: ![](https://files.readme.io/9b15121-image.png) Please advise how we'd go about adding this. There isn't a component like this documented on the schema component reference docs (<https://docs.rootplatform.com/docs/schema-component-reference#input-components>). Thanks
ANSWERED

Payments API: How to specify finalized_at

Good day We see example payment responses where there is a field called `finalized_at`. The create-async and update-async payment apis make no mention of this field. How would we specify this field?
ANSWERED

Cooling off period refund testing not working after rp pushing

After pushing version 90.5 to the OneSpark organisation (id d00e0ea4-0ee2-4c08-804d-61df85ca32ec) at 08:47:22 on Oct 31, I created policy number 899D385451 (id 4860bc3f-690f-400d-abb1-7cf7f72bb3ec) around 08:52:19 on Oct 31. I then proceeded to allocate an EFT payment for the policy a few minutes later from the policy details screen (https://app.root.co.za/orgs/d00e0ea4-0ee2-4c08-804d-61df85ca32ec/insurance/policies/4860bc3f-690f-400d-abb1-7cf7f72bb3ec) and then proceeded to cancel the policy. My expected result was that no refund would be allocated since the version pushed contains config which indicates the following: ` "coolingOffPeriod": { "applyTo": { "theFullPolicy": null } }, ` A refund was erroneously created. This is now the 3rd time I've ran this test and each time I end up getting the same result. I'm changing only the .root-config.json file and pushing from local doing `rp push --force`. Is that sufficient in testing this? (This is the way we test all changes before pushing to the dev branch)

GET /policies sorting

Good day 1. What is the default sort order of [this endpoint](https://docs.rootplatform.com/reference/list-all-policies-1)? 2. Is there a way to change this sorting? 1. I see when inspecting the network panel that for some endpoints there is an optional `sort[date_field_name]=desc` column. Can this be added to this endpoint too?

Payments API: Failure Reason and Comms Super Buggy

Good day, We have been battling to work out how to get the payments API to work as expected. We either get failure reasons for payments to pull through to the UI and then no comms fire or we get comms to fire but then our async updates to failure reason does not work. An example of a policy where we have this is here: <https://app.root.co.za/orgs/f0f74964-62a3-4bf1-9077-e6059a5c2ae2/insurance/policies/693814b4-fa55-4db7-b6a1-b7857eef0c95> 1. For the first payment (comms fire, failure reason not pulling through with an update): 1. We created the payment with a FAILED status, we then tried updating it using the payments endpoint and the job returned an OK 1. The payment did not update as far as we can see to include the failure reason we sent 2. The email and SMS comms did fire 2. For the second batch (comms don't fire, failure reason does pull through with an update) 1. We create the intial payments in PROCESSING or SUBMITTED 2. We then update using the update endpoint 1. The update to add the failure reason (as the creat endpoint does not allow it to be specified) does not result in the payment object updating at all 2. The SMS and email comms do fire 3. Emails and SMS do not fire 4. The failure update reflects both on the object and the UI 1. The updated at does not change 2. The finalized at does seem to have changed 3. Everything on the update object is required (the docs say only payment_id and status are required) Can you please assist with the above? Additionally, is there a DELETE endpoint? If not how would we delete payments if we needed to? I don't have the first payment's create and update requests but the second batches are: Create the initial payments ``` [ { "status": "submitted", "payment_type": "premium", "premium_type": "recurring", "amount": 123, "description": "Failed-Test-submitted-premium-recurring-do-2-day", "payment_date": "2022-10-10T00:00:00.000Z", "collection_type": "debit_order_two_day", "external_reference": "233c9210-submitted-premium-recurring-do-2-day", "policy_id": "693814b4-fa55-4db7-b6a1-b7857eef0c95" }, { "status": "processing", "payment_type": "premium", "description": "Failed-Test-processing-premium-recurring-do-2-day", "premium_type": "recurring", "amount": 456, "external_reference": "233c9210-processing-premium-recurring-do-2-day", "payment_date": "2022-10-10T00:00:00.000Z", "collection_type": "debit_order_two_day", "policy_id": "693814b4-fa55-4db7-b6a1-b7857eef0c95" } ] ``` Update the above payments ``` [ { "payment_id": "6b13355f-8c38-4efb-9ced-8db4bf118eb0", "status": "failed", "failure_reason": "Account closed - Failed-Test-submitted-premium-recurring-do-2-day", "failure_action": "block_payment_method" }, { "payment_id": "d2d85efa-f209-4bb1-94df-2df1b0fee441", "status": "failed", "failure_reason": "Account closed - Failed-Test-processing-premium-recurring-do-2-day", "failure_action": "block_payment_method" } ] ```