> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/back-office-api-reference/payment-bo-api/interest-free-installment-guide-management.md).

# Interest Free Installment Guide Management

## Delete Interest-Free Installment Info

> \## Function Description\
> \* Delete interest-free installment info\
> \---\
> \## Detailed Description\
> \* Delete interest-free installment info\
> \---\
> \## Revision History\
> \* Release v2.00\_241007: Changed the request body format<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/payment/noInterestInstallmentGuideMgmt/deleteNoInterestInstallmentGuide":{"post":{"tags":["Interest-Free Installment Guide Management"],"summary":"Delete Interest-Free Installment Info","description":"## Function Description\n* Delete interest-free installment info\n---\n## Detailed Description\n* Delete interest-free installment info\n---\n## Revision History\n* Release v2.00_241007: Changed the request body format\n","operationId":"deleteNoInterestInstallmentGuide","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}},"required":true},"responses":{"200":{"description":"Interest-Free Installment Info Deleted Successfully"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Register/Modify Interest-Free Installment Info

> \## Function Description\
> \* Register/modify interest-free installment info\
> \---\
> \## Detailed Description\
> \* Receives the registration/modification type code and processes registration/modification of interest-free installment info<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SaveNoInterestInstallmentGuideRequest":{"type":"object","description":"Interest-Free Installment Registration/Modification DTO","properties":{"acqrCd":{"type":"string","description":"Acquirer"},"argInsertUpdate":{"type":"string","description":"Register/Modify Type Code"},"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Guide No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"nintInstNm":{"type":"string","description":"Interest-Free Installment Name"},"sctnNintYn":{"type":"string","description":"Partial Interest-Free Status"},"useYn":{"type":"string","description":"Usage Status"},"nintAplyTgtCont":{"type":"string","description":"Interest-Free Installment Eligible Details"},"nintExcpTgtCont":{"type":"string","description":"Interest-Free Installment Excluded Details"},"installmentMonthInfos":{"type":"array","description":"Interest-Free Installment Detail Info List","items":{"$ref":"#/components/schemas/InstallmentMonthInfo"}}}},"InstallmentMonthInfo":{"type":"object","properties":{"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Info No."},"tgtAmt":{"type":"number","description":"Target Amount"},"nint1MonYn":{"type":"string","description":"Interest-Free 1-Month Status"},"nint2MonYn":{"type":"string","description":"Interest-Free 2-Month Status"},"nint3MonYn":{"type":"string","description":"Interest-Free 3-Month Status"},"nint4MonYn":{"type":"string","description":"Interest-Free 4-Month Status"},"nint5MonYn":{"type":"string","description":"Interest-Free 5-Month Status"},"nint6MonYn":{"type":"string","description":"Interest-Free 6-Month Status"},"nint7MonYn":{"type":"string","description":"Interest-Free 7-Month Status"},"nint8MonYn":{"type":"string","description":"Interest-Free 8-Month Status"},"nint9MonYn":{"type":"string","description":"Interest-Free 9-Month Status"},"nint10MonYn":{"type":"string","description":"Interest-Free 10-Month Status"},"nint11MonYn":{"type":"string","description":"Interest-Free 11-Month Status"},"nint12MonYn":{"type":"string","description":"Interest-Free 12-Month Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/noInterestInstallmentGuideMgmt/saveNoInterestInstallmentGuide":{"post":{"tags":["Interest-Free Installment Guide Management"],"summary":"Register/Modify Interest-Free Installment Info","description":"## Function Description\n* Register/modify interest-free installment info\n---\n## Detailed Description\n* Receives the registration/modification type code and processes registration/modification of interest-free installment info\n","operationId":"saveNoInterestInstallmentGuide","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveNoInterestInstallmentGuideRequest"}}},"required":true},"responses":{"200":{"description":"Interest-Free Installment Info Registered/Modified Successfully"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Search Interest-Free Installment Info Details

> \## Function Description\
> \* Search interest-free installment info details\
> \---\
> \## Detailed Description\
> \* Search interest-free installment info details<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NoInterestInstallmentResponse":{"type":"object","properties":{"sysModDtm":{"type":"string","format":"date-time","description":"Modification Date/Time"},"sysModId":{"type":"string","description":"Modifier"},"state":{"type":"string","description":"Progress Status"},"argInsertUpdate":{"type":"string","description":"Register/Modify Type Code"},"acqrCd":{"type":"string","description":"Purchasing Company (OM028)"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Guide No."},"nintInstNm":{"type":"string","description":"Interest-Free Installment Name"},"sctnNintYn":{"type":"string","description":"Partial Interest-Free Status"},"useYn":{"type":"string","description":"Usage Status"},"nintAplyTgtCont":{"type":"string","description":"Interest-Free Installment Eligible Details"},"nintExcpTgtCont":{"type":"string","description":"Interest-Free Installment Excluded Details"},"monthResponseList":{"type":"array","description":"Interest-Free Installment Guide Detail Information List","items":{"$ref":"#/components/schemas/InstallmentMonthInfo"}}}},"InstallmentMonthInfo":{"type":"object","properties":{"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Info No."},"tgtAmt":{"type":"number","description":"Target Amount"},"nint1MonYn":{"type":"string","description":"Interest-Free 1-Month Status"},"nint2MonYn":{"type":"string","description":"Interest-Free 2-Month Status"},"nint3MonYn":{"type":"string","description":"Interest-Free 3-Month Status"},"nint4MonYn":{"type":"string","description":"Interest-Free 4-Month Status"},"nint5MonYn":{"type":"string","description":"Interest-Free 5-Month Status"},"nint6MonYn":{"type":"string","description":"Interest-Free 6-Month Status"},"nint7MonYn":{"type":"string","description":"Interest-Free 7-Month Status"},"nint8MonYn":{"type":"string","description":"Interest-Free 8-Month Status"},"nint9MonYn":{"type":"string","description":"Interest-Free 9-Month Status"},"nint10MonYn":{"type":"string","description":"Interest-Free 10-Month Status"},"nint11MonYn":{"type":"string","description":"Interest-Free 11-Month Status"},"nint12MonYn":{"type":"string","description":"Interest-Free 12-Month Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/noInterestInstallmentGuideMgmt/getInterestFreeInstallmentInfoUpdate":{"get":{"tags":["Interest-Free Installment Guide Management"],"summary":"Search Interest-Free Installment Info Details","description":"## Function Description\n* Search interest-free installment info details\n---\n## Detailed Description\n* Search interest-free installment info details\n","operationId":"getInterestFreeInstallmentInfoUpdate","parameters":[{"name":"nintInstGdNo","in":"query","description":"Interest-Free Installment Guide No.","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Interest-Free Installment Info Details Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NoInterestInstallmentResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Search Interest-Free Installment Info Management

> \## Function Description\
> \* Search interest-free installment info management\
> \---\
> \## Detailed Description\
> \* Search interest-free installment info management<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"OpNintInstGdBaseRequest":{"type":"object","description":"Interest-Free Installment Guide Management List Inquiry DTO","properties":{"state":{"type":"string","description":"Progress Status"},"acqrCd":{"type":"string","description":"Purchasing Company (OM028)"},"startDate":{"type":"string","format":"date","description":"Search Start Date"},"endDate":{"type":"string","format":"date","description":"Search End Date"},"aplyStrTotal":{"type":"string","description":"Full Date Range Retrieval Status"},"sctnNintYn":{"type":"string","description":"Partial Interest-Free Status"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Guide No."}}},"RealGridListResponseOpNintInstGdBaseResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OpNintInstGdBaseResponse"}}}},"OpNintInstGdBaseResponse":{"type":"object","properties":{"state":{"type":"string","description":"Progress Status"},"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Guide No."},"acqrCd":{"type":"string","description":"Acquirer"},"nintInstNm":{"type":"string","description":"Interest-Free Installment Name"},"aplyStrDtm":{"type":"string","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","description":"Application End Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/noInterestInstallmentGuideMgmt/getInterestFreeInstallmentInfoList":{"get":{"tags":["Interest-Free Installment Guide Management"],"summary":"Search Interest-Free Installment Info Management","description":"## Function Description\n* Search interest-free installment info management\n---\n## Detailed Description\n* Search interest-free installment info management\n","operationId":"getInterestFreeInstallmentInfoList","parameters":[{"name":"opNintInstGdBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OpNintInstGdBaseRequest"}},{"name":"acqrCd","in":"query","description":"Acquirer","schema":{"type":"String"}},{"name":"state","in":"query","description":"Progress Status","schema":{"type":"String"}},{"name":"startDate","in":"query","description":"Search Start Date","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"Search End Date","required":true,"schema":{"type":"LocalDate"}},{"name":"aplyStrTotal","in":"query","description":"Full Date Range Retrieval Status","schema":{"type":"String"}}],"responses":{"200":{"description":"Interest-Free Installment Info Management Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOpNintInstGdBaseResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Check for Duplicate Acquirer Within the Applicable Period

> \## Function Description\
> \* Check for duplicate acquirer within the applicable period\
> \---\
> \## Detailed Description\
> \* When registering/modifying interest-free installment info, checks for overlap in the application start date/time and application end date/time based on the acquirer and partial interest-free usage status<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"OpNintInstGdBaseRequest":{"type":"object","description":"Interest-Free Installment Guide Management List Inquiry DTO","properties":{"state":{"type":"string","description":"Progress Status"},"acqrCd":{"type":"string","description":"Purchasing Company (OM028)"},"startDate":{"type":"string","format":"date","description":"Search Start Date"},"endDate":{"type":"string","format":"date","description":"Search End Date"},"aplyStrTotal":{"type":"string","description":"Full Date Range Retrieval Status"},"sctnNintYn":{"type":"string","description":"Partial Interest-Free Status"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"nintInstGdNo":{"type":"string","description":"Interest-Free Installment Guide No."}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/noInterestInstallmentGuideMgmt/getAcqrCheck":{"get":{"tags":["Interest-Free Installment Guide Management"],"summary":"Check for Duplicate Acquirer Within the Applicable Period","description":"## Function Description\n* Check for duplicate acquirer within the applicable period\n---\n## Detailed Description\n* When registering/modifying interest-free installment info, checks for overlap in the application start date/time and application end date/time based on the acquirer and partial interest-free usage status\n","operationId":"getClaimDiscountAcqrCheck","parameters":[{"name":"opNintInstGdBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OpNintInstGdBaseRequest"}},{"name":"nintInstGdNo","in":"query","description":"Interest-Free Installment Guide No.","required":true,"schema":{"type":"String"}},{"name":"acqrCd","in":"query","description":"Acquirer","required":true,"schema":{"type":"String"}},{"name":"aplyStrDtm","in":"query","description":"Application Start Date/Time","required":true,"schema":{"type":"LocalDateTime"}},{"name":"aplyEndDtm","in":"query","description":"Application End Date/Time","required":true,"schema":{"type":"LocalDateTime"}},{"name":"sctnNintYn","in":"query","description":"Partial Interest-Free Status","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Duplicate Acquirer Check Within Applicable Period Successful","content":{"*/*":{"schema":{"type":"boolean"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
