SSL Certificate Renewal.
| Input Parameters | Description | Type | Regular Expression | Mandatory |
| handle | Handle of the certificate to renew | string | Yes | |
| CSR | CSR of the certificate to renew | string | No | |
| period | Renew Period | 1 2 3 |
Yes | |
| validationMethod | Validation method of the certificate to renew | E-mail DNS |
No | |
| SHA | Encryption algorithm of the certificate to renew | SHA1 SHA2 |
No | |
| contact type=”contact1″ | Handle of the first contact | string | No | |
| contact type=”contact2″ | Handle of the second contact | string | No | |
| contact type=”organization” | Handle of the organization contact | string | No | |
| contact type=”requestor” | Handle of the requestor contact | string | No | |
| contact type=”approvedSigner” | Handle of the approved signer contact | string | No | |
| organizationCategory | Type of organization | PO GE BE |
PO: Private Organization GE: Government Entity BE: Business Entity |
No |
| requestorOrganizationUnit | Requestor contact’s service within the organization | string | No | |
| requestorFunction | Requestor contact’s function within the organization | string | No | |
| authorizedSignerFunction | Approved signer contact’s function within the organization | string | No |
| Outgoing Parameters | Description | Possible values |
| status | Order status | PENDING |
Error Codes
| Error code | Parameter | Message | Value | Comment |
| 706 | Unexpected error | Error:… | Unexpected error. Please contact Namebay for more information. | |
| 723 | You’re not Reseller of the SSL certificate or the handle doesn’t exist | You’re not Reseller of the SSL certificate or the handle doesn’t exist | The chosen certificate doesn’t belong to you or the handle doesn’t exist. | |
| 724 | The handle doesn’t point to an SSL certificate | The handle doesn’t point to an SSL certificate | The handle you entered isn’t an SSL certificate handle. | |
| 726 | It’s either too early or too late to renew this SSL certificate | It’s either too early or too late to renew this SSL certificate | The chosen certificate isn’t actually renewable. |
Request
| <api> […] <command> <ssl_order> <handle>…</handle> <CSR>…</CSR> <period>…</period> <validationMethod>…</validationMethod> <SHA>…</SHA> <contact type="contact1">…</contact> <contact type="contact2">…</contact> <contact type="organization">…</contact> <contact type="requestor">…</contact> <contact type="approver">…</contact> <contact type="approvedSigner">…</contact> <organizationCategory>…</organizationCategory> <requestorOrganizationUnit>…</requestorOrganizationUnit> <requestorFunction>…</requestorFunction> <authorizedSignerFunction>…</authorizedSignerFunction> </ssl_order> </command> </api> |
Response
| <?xml version="1.0" encoding="utf-8"?> <api> <response> <trID>…</trID> <result code="…"> <msg>…</msg> </result> </response> <resData> <ssl_orderData> <status>…</status> </ssl_orderData> </resData> </api> |