Marketplace
Marketplace service has been prepared to provide payment with credit card to company/websites that provided marketplace service by NomuPay. Below are methods and explanations that can be used in marketplace scenario.
Successful and unsuccessful result pages are created to give information to users.In the event of a system failure, it is necessary to use transaction result services in order to avoid situations where the end user does not have access to the successful or failed page.
You can access the most appropriate transaction service for you by clicking Here
Document Verification
Add Sub Merchant (Individual)
Add sub merchant method will be used for the definition of a new account that can sell products through the marketplace. The information to be transmitted during the identification of this account, which can sell products through the marketplace, must be prepared in XML message format.
https://www.nomupay.com.tr/SGate/Gate
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "AddSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class No AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String No Tax Office
TaxNumber String No Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String No IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String No Signature Authority Name
Surname String No Signature Authority Surname
BirthDate YYYY/MM/DD No Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
SubPartnerId Int The unique id value set by the NomuPay to the result of add marketplace process.
Add Sub Merchant (Private Company)
Add sub merchant method will be used for the definition of a new account that can sell products through the marketplace. The information to be transmitted during the identification of this account, which can sell products through the marketplace, must be prepared in XML message format.
https://www.nomupay.com.tr/SGate/Gate
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "AddSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class No AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String No Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String No IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String No Signature Authority Name
Surname String No Signature Authority Surname
BirthDate YYYY/MM/DD No Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
SubPartnerId Int The unique id value set by the NomuPay to the result of add marketplace process.
Add Sub Merchant (Corporation)
Add sub merchant method will be used for the definition of a new account that can sell products through the marketplace. The information to be transmitted during the identification of this account, which can sell products through the marketplace, must be prepared in XML message format.
https://www.nomupay.com.tr/SGate/Gate
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "AddSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class No AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String No TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String Yes Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String No IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String No Signature Authority Name
Surname String No Signature Authority Surname
BirthDate YYYY/MM/DD No Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
SubPartnerId Int The unique id value set by the NomuPay to the result of add marketplace process.
Update Sub Merchant (Individual)
Update sub merchant method will be used for updating account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Update Sub Merchant method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "UpdateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
SubPartnerId Int Yes Unique id value of the store record which will be updated.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class No AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String No Tax Office
TaxNumber String No Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String No IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String No Signature Authority Name
Surname String No Signature Authority Surname
BirthDate YYYY/MM/DD No Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
Update Sub Merchant (Private Company)
Update sub merchant method will be used for updating account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Update Sub Merchant method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "UpdateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
SubPartnerId Int Yes Unique id value of the store record which will be updated.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class No AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String No Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String No IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String No Signature Authority Name
Surname String No Signature Authority Surname
BirthDate YYYY/MM/DD No Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
Update Sub Merchant (Corporation)
Update sub merchant method will be used for updating account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Update Sub Merchant method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "UpdateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
SubPartnerId Int Yes Unique id value of the store record which will be updated.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class No AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String No TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String Yes Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String No IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String No Signature Authority Name
Surname String No Signature Authority Surname
BirthDate YYYY/MM/DD No Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
Deactivate Sub Merchant
Deactivate sub merchant method will be used for deactivate account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Deactivate Sub Merchant method are as follows:
Service Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "DeactivateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store.
-
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay.
Pin String Yes Pin value is set by NomuPay
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
Online Verification
Create Sub Merchant
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "WDTicket"
OperationType String Yes Static Value: "CreateSPRegistrationURL"
Token Token Sınıfı Yes Token Informations. The following internal table describes the internal parameters.
UniqueId Int Yes Id to be assigned to SP by Member Business
SubPartnerType Int No Store Type:
There can be three different values:
1. Individual
2. Private Company
3. Corporation -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Evet Pin value is set by NomuPay
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Create Sub Merchant Process
0: Process Successful
1: Process UnsuccessfulResultCode String If the query is not successful, the error code is returned.
ResultMessage String If the query is not successful, the error description is returned.
ReturnUrl String If the query is successful, the "link to the application form" is returned.
Add Sub Merchant (Individual)
Add sub merchant method will be used for the definition of a new account that can sell products through the marketplace. The information to be transmitted during the identification of this account, which can sell products through the marketplace, must be prepared in XML message format.
https://www.nomupay.com.tr/SGate/Gate
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "AddSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. SuccessURL String Yes URL to which the end user will be redirected after a successful subpartner addition request
ErrorURL String Yes URL to which the end-user will be redirected after a failed subpartner addition request
ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class Yes AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String No Tax Office
TaxNumber String No Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String Yes IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String Yes Signature Authority Name
Surname String Yes Signature Authority Surname
BirthDate YYYY/MM/DD Yes Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String Online Contract Link.
SubPartnerId Int The unique id value set by the NomuPay to the result of add marketplace process.
Add Sub Merchant (Private Company)
Add sub merchant method will be used for the definition of a new account that can sell products through the marketplace. The information to be transmitted during the identification of this account, which can sell products through the marketplace, must be prepared in XML message format.
https://www.nomupay.com.tr/SGate/Gate
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "AddSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. SuccessURL String Yes URL to which the end user will be redirected after a successful subpartner addition request
ErrorURL String Yes URL to which the end-user will be redirected after a failed subpartner addition request
ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class Yes AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String Yes Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String Yes IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String Yes Signature Authority Name
Surname String Yes Signature Authority Surname
BirthDate YYYY/MM/DD Yes Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String Online Contract Link.
SubPartnerId Int The unique id value set by the NomuPay to the result of add marketplace process.
Add Sub Merchant (Corporation)
Add sub merchant method will be used for the definition of a new account that can sell products through the marketplace. The information to be transmitted during the identification of this account, which can sell products through the marketplace, must be prepared in XML message format.
https://www.nomupay.com.tr/SGate/Gate
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "AddSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. SuccessURL String Yes URL to which the end user will be redirected after a successful subpartner addition request
ErrorURL String Yes URL to which the end-user will be redirected after a failed subpartner addition request
ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class Yes AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String Yes Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String Yes IBAN Info
TradeRegisterNumber String Yes Trade Register Number
TradeChamber String Yes Trade Chamber
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String Yes Signature Authority Name
Surname String Yes Signature Authority Surname
BirthDate YYYY/MM/DD Yes Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String Online Contract Link.
SubPartnerId Int The unique id value set by the NomuPay to the result of add marketplace process.
Update Sub Merchant (Individual)
Update sub merchant method will be used for updating account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Update Sub Merchant method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "UpdateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
SubPartnerId Int Yes Unique id value of the store record which will be updated.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class Yes AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String No Tax Office
TaxNumber String No Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String Yes IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String Yes Signature Authority Name
Surname String Yes Signature Authority Surname
BirthDate YYYY/MM/DD Yes Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String Online Contract Link.
Update Sub Merchant (Private Company)
Update sub merchant method will be used for updating account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Update Sub Merchant method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "UpdateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
SubPartnerId Int Yes Unique id value of the store record which will be updated.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class Yes AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String Yes Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String Yes IBAN Info
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String Yes Signature Authority Name
Surname String Yes Signature Authority Surname
BirthDate YYYY/MM/DD Yes Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String Online Contract Link.
Update Sub Merchant (Corporation)
Update sub merchant method will be used for updating account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Update Sub Merchant method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "UpdateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
SubPartnerId Int Yes Unique id value of the store record which will be updated.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.UniqueId String Yes Unique id value which be set by the member company for the store
SubPartnerType Enum Yes Store Type:
There can be three different values:
1. Individual
2. Private Company
3. CorporationName String Yes Store Type
BranchName String No It allows the name of the branch to be identified. ContactInfo ContactInfo Class Yes Contact Info Informations. The following internal table describes the internal parameters. FinancialInfo FinancialInfo Class Yes FinancialInfo Informations. The following internal table describes the internal parameters. AuthSignatory AuthSignatory Class Yes AuthSignatory Informations. The following internal table describes the internal parameters. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
ContactInfo Informations
Parameter Name Data Type Mandatory Description Country String Yes Country of Store Exp: TR
City String Yes City Code of Store Exp: 34
Address String Yes Store Address
BusinessPhone String No Store Phone Number
MobilePhone String Yes Mobile phone number of the store owner or authorized person
Email String Yes E-mail address to the store or store owner
InvoiceEmail String No Email address to which billing information will be forwarded
-
FinancialInfo Informations
Parameter Name Data Type Mandatory Description IdentityNumber String Yes TC identity number of the store owner or authorized person
TaxOffice String Yes Tax Office
TaxNumber String Yes Tax Number
BankName String Yes Bank code: Exp: 0019
IBAN String Yes IBAN Info
TradeRegisterNumber String Yes Trade Register Number
TradeChamber String Yes Trade Chamber
-
AuthSignatory Informations
Parameter Name Data Type Mandatory Description Name String Yes Signature Authority Name
Surname String Yes Signature Authority Surname
BirthDate YYYY/MM/DD Yes Signature Authority BirthDate
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String Online Contract Link.
Deactivate Sub Merchant
Deactivate sub merchant method will be used for deactivate account information which created for selling product, through the marketplace.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Deactivate Sub Merchant method are as follows:
Service Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "DeactivateSubPartner"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
UniqueId String Yes Unique id value which be set by the member company for the store.
-
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay.
Pin String Yes Pin value is set by NomuPay
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.
Payment With 3D Secure
The payment method with 3D Secure is a process used to complete credit card payment transactions via the bank's "3DSEC" verification page.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Payment With 3D Secure method are as follows:
Service Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "Sale3DSEC"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
CreditCardInfo CreditCardInfo Class Yes CreditCardInfo Informations. The following internal table describes the internal parameters. CardTokenization CardTokenization Class Yes CardTokenization Informations. The following internal table describes the internal parameters.
During credit card transaction, if the transaction card is requested to be recorded on the NomuPay system, or if a transaction is performed with a previously recorded card is requested, values under this class will be sent in full.CustomerInfo CustomerInfo Class No CustomerInfo Informations. The following internal table describes the internal parameters. Language String No Information is the language in which the e-mail will be provided.
TR: Turkish
EN: EnglishPort String No Port information of the end user performing the payment transaction
MPAY String No Free Value
Merchant’s unique transaction id can be sent via this parameter.CurrencyCode String No TRY/USD/EUR
Currency Code : TRY/USD/EURIPAddress String Yes IP address information of the end user performing the payment transaction
Port String Yes Port information of the end user performing the payment transaction
Description String Yes The content of the payment transaction
InstallmentCount Int Yes Installment Count:
0: One shot
3: 3 installment
6: 6 installment
9: 9 installmentErrorURL String Yes The end user will redirect to the URL after a failed operation
The end user will be directed to this page after the "3DSEC" verification stepSuccessURL String Yes The end user will redirect to the URL after successful operation
The end user will be directed to this page after the "3DSEC" verification stepCommissionRate Int Yes The amount of the commission to be applied to the store for payment.
Commision value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110
Parameter field specified is essential in our companies which will work with installment structure and dynamic ratio.ExtraParam String No Parameter value to be used to trigger additional options in the method
Should be left empty for the payment with 3D.PaymentContent String No Content of the payment transaction
SubPartnerId Int Yes Unique id value of the store record which will be processed payment.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message. -
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
CustomerInfo Information
Parameter Name Data Type Mandatory Description CustomerName String No Name of the person to be informed
CustomerSurname String No Surname of the person to be informed
CustomerEmail String No E-mail of the person to be informed
-
CreditCardInfo Informations
Parameter Name Data Type Mandatory Description CreditCardNo String Yes Credit card number to be used for payment
Should be in ‘5400XXXXXXXXXXXX’ formatOwnerName String Yes Name which is on the credit card
Should be in ‘John Doe’ or ‘JOHN DOE’ formatExpireYear Int Yes Expire year of the credit card
Should be in ‘2017’ formatExpireMonth Int Yes Expire month of the credit card
Should be in ‘1,7,10,12, etc’ format.Cvv String Yes The CVV value on the back of the credit card
Price Int Yes Amount of payment
Real value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110. -
CardTokenization Informations
Parameter Name Data Type Mandatory Description RequestType Int Yes It can be sent as 0 or 1.
0: No action.
1: Performs payment and card registrationCustomerId String Yes This value should be sent as "1" if card recording is wanted during payment processing. It is mandatory to send this value for the same situation.
ValidityPeriod int Yes Credit card token record expiration date should be sent as 0. This field is required if you want to save the transaction credit card.
CCTokenId Guid Yes Token value assigned by NomuPay for a previously created card. If this value is full, no credit card information needs to be entered.
NomuPay Common Payment Page
The NomuPay Common Payment Page allows payment via the member company system using the 3D Secure feature.
https://www.nomupay.com.tr/SGate/Gate
The parameters for NomuPay Common Payment Page method are as follows:
Serivce Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "WDTicket"
OperationType String Yes Static Value: "MPSale3DSECWithUrl"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
CustomerInfo CustomerInfo Class No CustomerInfo Informations. The following internal table describes the internal parameters. Language String No Information is the language in which the e-mail will be provided.
TR: Turkish
EN: EnglishSubPartnerId Int Yes Unique id value of the store record which will be processed payment.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.Price Int Yes Amount of payment
Real value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110.CommissionRate Int Yes The amount of the commission to be applied to the store for payment.
Commision value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110MPAY String No Free Value
Merchant’s unique transaction id can be sent via this parameter.CurrencyCode String No TRY/USD/EUR
Currency Code : TRY/USD/EURInstallmentOptions Int No Installment Count:
0: One shot
3: 3 installment
6: 6
9: 9 installmentCommissionRateList Int No If companies will work in installment structure and only with
dynamic rate, have to send this parameter field.
The internal parameters and data type that should be added
to the parameter internal table are as follows.
<Inst0>int</Inst0>
<Inst3>int</Inst3>
<Inst6>int</Inst6>
<Inst9>int</Inst9>
If 0,3,6,9 values are available in the Installation Options
parameter, the values of Inst0, Inst3, Inst6 and Inst9
parameters should be specified.ErrorURL String Yes The end user will redirect to the URL after a failed operation
The end user will be directed to this page after the "3DSEC" verification stepSuccessURL String Yes The end user will redirect to the URL after successful operation
The end user will be directed to this page after the "3DSEC" verification stepExtraParam String No Parameter value to be used to trigger additional options in the method
Should be left empty for the payment with 3D.Description String Yes The content of the payment transaction
PaymentContent String No Content of the payment transaction
-
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
-
CustomerInfo Information
Parameter Name Data Type Mandatory Description CustomerName String No Name of the person to be informed
CustomerSurname String No Surname of the person to be informed
CustomerEmail String No E-mail of the person to be informed
Service Output Parameters
-
Service Output Parameters
Parameter Name Data Type Description StatusCode Int Process Result
0: Process Successful
1: Process UnsuccessfulResultCode String NomuPay result code of the payment transaction
ResultMessage String Description of ResultCode value.
OrderObjectId Guid Unique id of the payment transaction
This value is set automatically by NomuPay services.RedirectUrl String The end user will be directed to this URL for 3DSEC validation.
The end user must be directed to this URL to complete the 3DSEC step.
Sub Merchant Payment Confirmation
The Sub Merchant Payment Method provides that the amount of the paid transaction is confirmed for transfer to the store, if it was predefined for the member.
https://www.nomupay.com.tr/SGate/Gate
The parameters for Sub Merchant Payment Confirmation method are as follows:
Service Input Parameters
-
Input Informations
Parameter Name Data Type Mandatory Description ServiceType String Yes Static Value: "CCMarketPlace"
OperationType String Yes Static Value: "ReleasePayment"
Token Token Class Yes Token Informations. The following internal table describes the internal parameters.
CommissionRate Int No The amount of the commission to be applied to the store for payment.
Commision value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110SubPartnerId Int Yes Unique id value of the store record which will be processed payment.
This value is created by NomuPay during the Add Marketplace service call and is shared via the Add Marketplace response message.MPAY String No Free Value
Merchant’s unique transaction id can be sent via this parameter.OrderId Guid - The unique id value for the payment to be processed.
If the MPAY value is used for the Payment Confirmation, this value does not need to be sent. It should be used when MPAY is not sent.Description String Yes Transaction Description
-
Token Informations
Parameter Name Data Type Mandatory Description UserCode String Yes Merchant value is set by NomuPay
Pin String Yes Pin value is set by NomuPay
Service Output Patameters
-
Service Output Patameters
Parameter Name Data Type Description StatusCode Int Result of Add Marketplace Process
0: Process Successful
1: Process UnsuccessfulResultCode String The result code of add marketplace process which set by NomuPay
ResultMessage String ResultCode value description.