Alipay SDK for .NET

The AlipayOpenInstantdeliveryMerchantshopApi class provides methods to manage merchant shops within the instant delivery scenario. It supports paginated querying, creating new shops, modifying existing shops, and retrieving shop details.

Available Methods

Common Setup and Authentication

All requests require an AlipayConfig object passed via AlipayConfigUtil to the API client. You can use either Key Mode or Certificate Mode.

Key Mode Configuration:

• AppId
• PrivateKey
• AlipayPublicKey
• EncryptKey

Configuration config = new Configuration();
config.BasePath = "https://openapi.alipay.com";
var apiInstance = new AlipayOpenInstantdeliveryMerchantshopApi(config);

AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.AppId = "app_id";
alipayConfig.PrivateKey = "private_key";
alipayConfig.AlipayPublicKey = "alipay_public_key";
alipayConfig.EncryptKey = "encrypt_key";

AlipayConfigUtil alipayConfigUtil = new AlipayConfigUtil(alipayConfig);
apiInstance.Client.SetAlipayConfigUtil(alipayConfigUtil);

To use the Alipay SDK, you must configure an AlipayConfig object and wrap it in an AlipayConfigUtil. You can use either Key Mode or Certificate Mode.

Key Mode:

• AppId: Your application ID.
• PrivateKey: Your application's private key.
• AlipayPublicKey: Alipay's public key.
• EncryptKey: The encryption key.

Certificate Mode:

• AppCertPath: Path to your app certificate public key.
• AlipayPublicCertPath: Path to Alipay's public certificate.
• RootCertPath: Path to the root certificate.

// Key Mode Example
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.AppId = "app_id";
alipayConfig.PrivateKey = "private_key";
alipayConfig.AlipayPublicKey = "alipay_public_key";
alipayConfig.EncryptKey = "encrypt_key";

// Certificate Mode Example (uncomment to use)
// alipayConfig.AppCertPath = "../appCertPublicKey.crt";
// alipayConfig.AlipayPublicCertPath = "../alipayCertPublicKey_RSA2.crt";
// alipayConfig.RootCertPath = "../alipayRootCert.crt";

AlipayConfigUtil alipayConfigUtil = new AlipayConfigUtil(alipayConfig);
apiInstance.Client.SetAlipayConfigUtil(alipayConfigUtil);

To use the Alipay SDK, follow these three main steps:

1. Initialize the client: Create an instance of IAopClient (typically DefaultAopClient) with your gateway URL, AppID, private key, and certificate parameters.
2. Create the request: Instantiate the specific Request object for the API you want to call and populate its BizModel.
3. Execute and handle response: Use client.CertificateExecute(request) to send the request and check the IsError property of the response to handle success or failure.

Note: When using the recommended Certificate Mode, you must provide paths to your application public certificate, Alipay public certificate, and Alipay root certificate via CertParams.

using System;
using Aop.Api;
using Aop.Api.Request;
using Aop.Api.Response;
using Aop.Api.Domain;

namespace SDK.Demo
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                // 1. Create IAopClient instance
                IAopClient client = new DefaultAopClient(
                    "https://openapi.alipay.com/gateway.do",
                    "2019091767145019", // Replace with your AppId
                    "MIIEowIBAAKCAQ ... ...", // Replace with your PKCS1 format App Private Key
                    "json", "1.0", "RSA2",
                    "utf-8", // Replace with your character encoding, recommended: utf-8
                    false, GetCertParams());

                // 2. Create the Request object for the specific Open API
                AlipayOpenOperationOpenbizmockBizQueryRequest request = GetRequest();

                // 3. Execute request and handle response
                AlipayOpenOperationOpenbizmockBizQueryResponse response = client.CertificateExecute(request);
                if (!response.IsError)
                {
                    Console.WriteLine("Call successful.");
                }
                else
                {
                    Console.WriteLine("Call failed. Reason: " + response.Msg + ", " + response.SubMsg);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine("Exception occurred: " + e.Message);
                throw e;
            }
        }

        private static CertParams GetCertParams()
        {
            return new CertParams
            {
                // Replace with your application public certificate file path
                AlipayPublicCertPath = "/home/foo/alipayCertPublicKey_RSA2.crt",
                // Replace with your Alipay public certificate file path
                AppCertPath = "/home/foo/appCertPublicKey_2019090366875133.crt",
                // Replace with your Alipay root certificate file path
                RootCertPath = "/home/foo/alipayRootCert.crt"
            };
        }

        private static AlipayOpenOperationOpenbizmockBizQueryRequest GetRequest()
        {
            // Initialize Request and populate Model properties.
            AlipayOpenOperationOpenbizmockBizQueryRequest request = new AlipayOpenOperationOpenbizmockBizQueryRequest();
            AlipayOpenOperationOpenbizmockBizQueryModel model = new AlipayOpenOperationOpenbizmockBizQueryModel
            {
                BizNo = "123456789"
            };
            request.SetBizModel(model);
            return request;
        }
    }
}

To use the AlipayEbppInvoiceIssueruleApi, you must initialize a Configuration object and set up an AlipayConfig object. This configuration can be used in either Key Mode (using public keys) or Certificate Mode (using .crt files).

Key Mode Configuration:

• AppId: Your application ID.
• PrivateKey: Your application's private key.
• AlipayPublicKey: Alipay's public key.
• EncryptKey: The encryption key.

Certificate Mode Configuration:

• AppCertPath: Path to your application certificate.
• AlipayPublicCertPath: Path to Alipay's public certificate.
• RootCertPath: Path to the root certificate.

Once configured, wrap the AlipayConfig in an AlipayConfigUtil and pass it to the API client using apiInstance.Client.SetAlipayConfigUtil(alipayConfigUtil).

Configuration config = new Configuration();
config.BasePath = "https://openapi.alipay.com";
var apiInstance = new AlipayEbppInvoiceIssueruleApi(config);

// Setup AlipayConfig (Key Mode Example)
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.AppId = "app_id";
alipayConfig.PrivateKey = "private_key";
alipayConfig.AlipayPublicKey = "alipay_public_key";
alipayConfig.EncryptKey = "encrypt_key";

AlipayConfigUtil alipayConfigUtil = new AlipayConfigUtil(alipayConfig);
apiInstance.Client.SetAlipayConfigUtil(alipayConfigUtil);