diff --git a/src/codesamples/go.json b/src/codesamples/go.json index 53efadcb..7e44e8af 100644 --- a/src/codesamples/go.json +++ b/src/codesamples/go.json @@ -3,7 +3,7 @@ "language": "go", "sdk": { "module": "github.com/sumup/sumup-go", - "version": "0.18.0" + "version": "0.19.0" }, "openAPIVersion": "1.0.0", "samples": [ @@ -14,7 +14,7 @@ "description": "Creates an Apple Pay merchant session for the specified checkout.\n\nUse this endpoint after the customer selects Apple Pay and before calling\n`ApplePaySession.completeMerchantValidation(...)` in the browser.\nSumUp validates the merchant session request and returns the Apple Pay\nsession object that your frontend should pass to Apple's JavaScript API.", "httpMethod": "PUT", "path": "/v0.2/checkouts/{checkout_id}/apple-pay-session", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.CreateApplePaySession(ctx, \"string\", sumup.CheckoutsCreateApplePaySessionParams{\n\t\tContext: \"example.com\",\n\t\tTarget: \"https://apple-pay-gateway-cert.apple.com/paymentservices/startSession\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.CreateApplePaySession(context.TODO(), \"4e425463-3e1b-431d-83fa-1e51c2925e99\", sumup.CheckoutsCreateApplePaySessionParams{\n\t\tContext: \"example.com\",\n\t\tTarget: \"https://apple-pay-gateway-cert.apple.com/paymentservices/startSession\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateCheckout.Checkout", @@ -24,7 +24,7 @@ "description": "Standard request body for creating a checkout", "httpMethod": "POST", "path": "/v0.1/checkouts", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/nullable\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Create(ctx, sumup.CheckoutsCreateParams{\n\t\tAmount: 10.1,\n\t\tCheckoutReference: \"f00a8f74-b05d-4605-bd73-2a901bae5802\",\n\t\tCurrency: \"EUR\",\n\t\tDescription: ptr(\"Purchase\"),\n\t\tMerchantCode: \"MH4H92C7\",\n\t\tRedirectURL: ptr(\"https://sumup.com\"),\n\t\tValidUntil: nullable.Value(mustParseTime(\"2020-02-29T10:56:56+00:00\")),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n\nfunc mustParseTime(value string) time.Time {\n\tparsed, err := time.Parse(time.RFC3339, value)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treturn parsed\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/nullable\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Create(context.TODO(), sumup.CheckoutsCreateParams{\n\t\tAmount: 10.1,\n\t\tCheckoutReference: \"f00a8f74-b05d-4605-bd73-2a901bae5802\",\n\t\tCurrency: \"EUR\",\n\t\tDescription: new(\"Purchase\"),\n\t\tMerchantCode: \"MH4H92C7\",\n\t\tRedirectURL: new(\"https://sumup.com\"),\n\t\tValidUntil: nullable.Value(time.Date(2020, time.February, 29, 10, 56, 56, 0, time.UTC)),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateCheckout.Checkout3DS", @@ -34,7 +34,7 @@ "description": "Create a 3DS checkout", "httpMethod": "POST", "path": "/v0.1/checkouts", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Create(ctx, sumup.CheckoutsCreateParams{\n\t\tAmount: 10.1,\n\t\tCheckoutReference: \"f00a8f74-b05d-4605-bd73-2a901bae5802\",\n\t\tCurrency: \"EUR\",\n\t\tCustomerID: ptr(\"831ff8d4cd5958ab5670\"),\n\t\tDescription: ptr(\"Purchase\"),\n\t\tMerchantCode: \"MH4H92C7\",\n\t\tRedirectURL: ptr(\"https://mysite.com/completed_purchase\"),\n\t\tReturnURL: ptr(\"http://example.com/\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Create(context.TODO(), sumup.CheckoutsCreateParams{\n\t\tAmount: 10.1,\n\t\tCheckoutReference: \"f00a8f74-b05d-4605-bd73-2a901bae5802\",\n\t\tCurrency: \"EUR\",\n\t\tCustomerID: new(\"831ff8d4cd5958ab5670\"),\n\t\tDescription: new(\"Purchase\"),\n\t\tMerchantCode: \"MH4H92C7\",\n\t\tRedirectURL: new(\"https://mysite.com/completed_purchase\"),\n\t\tReturnURL: new(\"http://example.com/\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateCheckout.CheckoutAPM", @@ -44,7 +44,7 @@ "description": "Create an Alternative Payment Method checkout", "httpMethod": "POST", "path": "/v0.1/checkouts", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Create(ctx, sumup.CheckoutsCreateParams{\n\t\tAmount: 10.1,\n\t\tCheckoutReference: \"f00a8f74-b05d-4605-bd73-2a901bae5802\",\n\t\tCurrency: \"EUR\",\n\t\tMerchantCode: \"MH4H92C7\",\n\t\tRedirectURL: ptr(\"https://mysite.com/completed_purchase\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Create(context.TODO(), sumup.CheckoutsCreateParams{\n\t\tAmount: 10.1,\n\t\tCheckoutReference: \"f00a8f74-b05d-4605-bd73-2a901bae5802\",\n\t\tCurrency: \"EUR\",\n\t\tMerchantCode: \"MH4H92C7\",\n\t\tRedirectURL: new(\"https://mysite.com/completed_purchase\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateCheckout.HostedCheckout", @@ -54,7 +54,7 @@ "description": "Create a checkout with a SumUp-hosted payment page", "httpMethod": "POST", "path": "/v0.1/checkouts", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Create(ctx, sumup.CheckoutsCreateParams{\n\t\tAmount: 12,\n\t\tCheckoutReference: \"b50pr914-6k0e-3091-a592-890010285b3d\",\n\t\tCurrency: \"EUR\",\n\t\tDescription: ptr(\"A sample checkout\"),\n\t\tHostedCheckout: ptr(sumup.HostedCheckout{\n\t\t\tEnabled: true,\n\t\t}),\n\t\tMerchantCode: \"MCXXXXXX\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Create(context.TODO(), sumup.CheckoutsCreateParams{\n\t\tAmount: 12,\n\t\tCheckoutReference: \"b50pr914-6k0e-3091-a592-890010285b3d\",\n\t\tCurrency: \"EUR\",\n\t\tDescription: new(\"A sample checkout\"),\n\t\tHostedCheckout: new(sumup.HostedCheckout{\n\t\t\tEnabled: true,\n\t\t}),\n\t\tMerchantCode: \"MCXXXXXX\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateCustomer", @@ -63,7 +63,7 @@ "description": "Creates a new saved customer resource which you can later manipulate and save payment instruments to.", "httpMethod": "POST", "path": "/v0.1/customers", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Customers.Create(ctx, sumup.CustomersCreateParams{\n\t\tCustomerID: \"831ff8d4cd5958ab5670\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Customers.Create(context.TODO(), sumup.CustomersCreateParams{\n\t\tCustomerID: \"831ff8d4cd5958ab5670\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateGoReaderCheckout", @@ -72,7 +72,7 @@ "description": "Initiates a payment on the SumUp Go terminal identified by the reader ID.\n\nUse `client_transaction_id` as an idempotency key: retrying the request with the same value returns the result of the original payment instead of creating a duplicate.", "httpMethod": "POST", "path": "/v0/merchants/{merchant_code}/readers/{reader_id}/go-checkout", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.CreateGoCheckout(ctx, \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersCreateGoCheckoutParams{\n\t\tClientTransactionID: \"19e12390-72cf-4f9f-80b5-b0c8a67fa43f\",\n\t\tTipAmount: ptr(100),\n\t\tTotalAmount: sumup.Amount{\n\t\t\tCurrency: \"MXN\",\n\t\t\tValue: 1000,\n\t\t},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.CreateGoCheckout(context.TODO(), \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersCreateGoCheckoutParams{\n\t\tClientTransactionID: \"19e12390-72cf-4f9f-80b5-b0c8a67fa43f\",\n\t\tTipAmount: new(100),\n\t\tTotalAmount: sumup.Amount{\n\t\t\tCurrency: \"MXN\",\n\t\t\tValue: 1000,\n\t\t},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateMerchantMember", @@ -81,7 +81,7 @@ "description": "Create a merchant member.", "httpMethod": "POST", "path": "/v0.1/merchants/{merchant_code}/members", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Members.Create(ctx, \"MK10CL2A\", sumup.MembersCreateParams{\n\t\tEmail: \"karl.berg@example.com\",\n\t\tRoles: []string{\"role_employee\"},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Members.Create(context.TODO(), \"MK10CL2A\", sumup.MembersCreateParams{\n\t\tEmail: \"karl.berg@example.com\",\n\t\tRoles: []string{\"role_employee\"},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateMerchantRole", @@ -90,7 +90,7 @@ "description": "Create a custom role for the merchant. Roles are defined by the set of permissions that they grant to the members that they are assigned to.", "httpMethod": "POST", "path": "/v0.1/merchants/{merchant_code}/roles", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Roles.Create(ctx, \"MK10CL2A\", sumup.RolesCreateParams{\n\t\tDescription: ptr(\"Manges the shop and the employees.\"),\n\t\tMetadata: sumup.Metadata{},\n\t\tName: \"Senior Shop Manager II\",\n\t\tPermissions: []string{\"catalog_access\", \"taxes_access\", \"members_access\"},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Roles.Create(context.TODO(), \"MK10CL2A\", sumup.RolesCreateParams{\n\t\tDescription: new(\"Manges the shop and the employees.\"),\n\t\tMetadata: sumup.Metadata{},\n\t\tName: \"Senior Shop Manager II\",\n\t\tPermissions: []string{\"catalog_access\", \"taxes_access\", \"members_access\"},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateReader", @@ -99,7 +99,7 @@ "description": "Create a new Reader for the merchant account.", "httpMethod": "POST", "path": "/v0.1/merchants/{merchant_code}/readers", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.Create(ctx, \"MK10CL2A\", sumup.ReadersCreateParams{\n\t\tMetadata: sumup.Metadata{},\n\t\tName: \"Frontdesk\",\n\t\tPairingCode: \"4WLFDSBF\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.Create(context.TODO(), \"MK10CL2A\", sumup.ReadersCreateParams{\n\t\tMetadata: sumup.Metadata{},\n\t\tName: \"Frontdesk\",\n\t\tPairingCode: \"4WLFDSBF\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateReaderCheckout", @@ -108,7 +108,7 @@ "description": "Creates a Checkout for a Reader.\n\nThis process is asynchronous and the actual transaction may take some time to be started on the device.\n\n\nThere are some caveats when using this endpoint:\n* The target device must be online, otherwise checkout won't be accepted\n* After the checkout is accepted, the system has 60 seconds to start the payment on the target device. During this time, any other checkout for the same device will be rejected.\n\n\n**Note**: If the target device is a Solo, it must be in version 3.3.24.3 or higher.", "httpMethod": "POST", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}/checkout", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/nullable\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.CreateCheckout(ctx, \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersCreateCheckoutParams{\n\t\tAADE: ptr(sumup.CreateCheckoutRequestAADE{\n\t\t\tProviderID: \"123\",\n\t\t\tSignature: \"QjcxRDdBNTU1MDcyRTNFRTREMkZEM0Y0NTdBMjkxMTU4MzBFNkNCQTs7MjAyNTExMTIyMTQ3MTM7Nzk2OzEwNDs5MDA7OTAwOzU0ODg5MDM5\",\n\t\t\tSignatureData: \"B71D7A555072E3EE4D2FD3F457A29115830E6CBA;;20251112214713;796;104;900;900;54889039\",\n\t\t}),\n\t\tAffiliate: nullable.Value(sumup.CreateCheckoutRequestAffiliate{\n\t\t\tAppID: \"com.example.app\",\n\t\t\tForeignTransactionID: \"123456\",\n\t\t\tKey: \"ef7b684a-d6f4-4e93-9b1b-6acdd6564a8e\",\n\t\t\tTags: sumup.CreateCheckoutRequestAffiliateTags{},\n\t\t}),\n\t\tCardType: ptr(sumup.CreateCheckoutRequestCardType(\"debit\")),\n\t\tDescription: ptr(\"This is a description...\"),\n\t\tInstallments: nullable.Value(1),\n\t\tReturnURL: ptr(\"https://webhook.site/e21ddbb0-42c4-4358-a981-f5a95cd86fb5\"),\n\t\tTipRates: []float32{0.05, 0.1, 0.15},\n\t\tTipTimeout: ptr(60),\n\t\tTotalAmount: sumup.CreateCheckoutRequestTotalAmount{\n\t\t\tCurrency: \"EUR\",\n\t\t\tMinorUnit: 2,\n\t\t\tValue: 5033,\n\t\t},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/nullable\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.CreateCheckout(context.TODO(), \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersCreateCheckoutParams{\n\t\tAADE: new(sumup.CreateCheckoutRequestAADE{\n\t\t\tProviderID: \"123\",\n\t\t\tSignature: \"QjcxRDdBNTU1MDcyRTNFRTREMkZEM0Y0NTdBMjkxMTU4MzBFNkNCQTs7MjAyNTExMTIyMTQ3MTM7Nzk2OzEwNDs5MDA7OTAwOzU0ODg5MDM5\",\n\t\t\tSignatureData: \"B71D7A555072E3EE4D2FD3F457A29115830E6CBA;;20251112214713;796;104;900;900;54889039\",\n\t\t}),\n\t\tAffiliate: nullable.Value(sumup.CreateCheckoutRequestAffiliate{\n\t\t\tAppID: \"com.example.app\",\n\t\t\tForeignTransactionID: \"123456\",\n\t\t\tKey: \"ef7b684a-d6f4-4e93-9b1b-6acdd6564a8e\",\n\t\t\tTags: sumup.CreateCheckoutRequestAffiliateTags{},\n\t\t}),\n\t\tCardType: new(sumup.CreateCheckoutRequestCardType(\"debit\")),\n\t\tDescription: new(\"This is a description...\"),\n\t\tInstallments: nullable.Value(1),\n\t\tReturnURL: new(\"https://webhook.site/e21ddbb0-42c4-4358-a981-f5a95cd86fb5\"),\n\t\tTipRates: []float32{0.05, 0.1, 0.15},\n\t\tTipTimeout: new(60),\n\t\tTotalAmount: sumup.CreateCheckoutRequestTotalAmount{\n\t\t\tCurrency: \"EUR\",\n\t\t\tMinorUnit: 2,\n\t\t\tValue: 5033,\n\t\t},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "CreateReaderTerminate", @@ -117,7 +117,7 @@ "description": "Terminate a Reader Checkout stops the current transaction on the target device.\n\nThis process is asynchronous and the actual termination may take some time to be performed on the device.\n\n\nThere are some caveats when using this endpoint:\n* The target device must be online, otherwise terminate won't be accepted\n* The action will succeed only if the device is waiting for cardholder action: e.g: waiting for card, waiting for PIN, etc.\n* There is no confirmation of the termination.\n\nIf a transaction is successfully terminated and `return_url` was provided on Checkout, the transaction status will be sent as `failed` to the provided URL.\n\n\n**Note**: If the target device is a Solo, it must be in version 3.3.28.0 or higher.", "httpMethod": "POST", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}/terminate", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tif err := client.Readers.TerminateCheckout(ctx, \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\"); err != nil {\n\t\tlog.Fatal(err)\n\t}\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tif err := client.Readers.TerminateCheckout(context.TODO(), \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\"); err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n" }, { "id": "DeactivateCheckout", @@ -126,7 +126,7 @@ "description": "Deactivates an identified checkout resource. If the checkout has already been processed it can not be deactivated.", "httpMethod": "DELETE", "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Deactivate(ctx, \"string\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Deactivate(context.TODO(), \"4e425463-3e1b-431d-83fa-1e51c2925e99\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "DeactivatePaymentInstrument", @@ -135,7 +135,7 @@ "description": "Deactivates an identified card payment instrument resource for a customer.", "httpMethod": "DELETE", "path": "/v0.1/customers/{customer_id}/payment-instruments/{token}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tif err := client.Customers.DeactivatePaymentInstrument(ctx, \"string\", \"string\"); err != nil {\n\t\tlog.Fatal(err)\n\t}\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tif err := client.Customers.DeactivatePaymentInstrument(context.TODO(), \"831ff8d4cd5958ab5670\", \"bcfc8e5f-3b47-4cb9-854b-3b7a4cce7be3\"); err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n" }, { "id": "DeleteMerchantMember", @@ -144,7 +144,7 @@ "description": "Deletes a merchant member.", "httpMethod": "DELETE", "path": "/v0.1/merchants/{merchant_code}/members/{member_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tif err := client.Members.Delete(ctx, \"MK10CL2A\", \"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\"); err != nil {\n\t\tlog.Fatal(err)\n\t}\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tif err := client.Members.Delete(context.TODO(), \"MK10CL2A\", \"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\"); err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n" }, { "id": "DeleteMerchantRole", @@ -153,7 +153,7 @@ "description": "Delete a custom role.", "httpMethod": "DELETE", "path": "/v0.1/merchants/{merchant_code}/roles/{role_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tif err := client.Roles.Delete(ctx, \"MK10CL2A\", \"role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\"); err != nil {\n\t\tlog.Fatal(err)\n\t}\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tif err := client.Roles.Delete(context.TODO(), \"MK10CL2A\", \"role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\"); err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n" }, { "id": "DeleteReader", @@ -162,7 +162,7 @@ "description": "Delete a reader.", "httpMethod": "DELETE", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tif err := client.Readers.Delete(ctx, \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\"); err != nil {\n\t\tlog.Fatal(err)\n\t}\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tif err := client.Readers.Delete(context.TODO(), \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\"); err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n" }, { "id": "GetCheckout", @@ -171,7 +171,7 @@ "description": "Retrieves an identified checkout resource. Use this request after processing a checkout to confirm its status and inform the end user respectively.", "httpMethod": "GET", "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Get(ctx, \"string\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Get(context.TODO(), \"4e425463-3e1b-431d-83fa-1e51c2925e99\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetCustomer", @@ -180,7 +180,7 @@ "description": "Retrieves an identified saved customer resource through the unique `customer_id` parameter, generated upon customer creation.", "httpMethod": "GET", "path": "/v0.1/customers/{customer_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Customers.Get(ctx, \"string\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Customers.Get(context.TODO(), \"831ff8d4cd5958ab5670\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetMerchant", @@ -189,7 +189,7 @@ "description": "Returns a Merchant for a valid Merchant code.", "httpMethod": "GET", "path": "/v1/merchants/{merchant_code}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Merchants.Get(ctx, \"MK10CL2A\", sumup.MerchantsGetParams{\n\t\tVersion: ptr(\"latest\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Merchants.Get(context.TODO(), \"MK10CL2A\", sumup.MerchantsGetParams{\n\t\tVersion: new(\"latest\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetMerchantMember", @@ -198,7 +198,7 @@ "description": "Retrieve a merchant member.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/members/{member_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Members.Get(ctx, \"MK10CL2A\", \"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Members.Get(context.TODO(), \"MK10CL2A\", \"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetMerchantRole", @@ -207,7 +207,7 @@ "description": "Retrieve a custom role by ID.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/roles/{role_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Roles.Get(ctx, \"MK10CL2A\", \"role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Roles.Get(context.TODO(), \"MK10CL2A\", \"role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetPaymentMethods", @@ -216,7 +216,7 @@ "description": "Get payment methods available for the given merchant to use with a checkout.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/payment-methods", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.ListAvailablePaymentMethods(ctx, \"MH4H92C7\", sumup.CheckoutsListAvailablePaymentMethodsParams{\n\t\tAmount: ptr(float64(9.99)),\n\t\tCurrency: ptr(\"EUR\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.ListAvailablePaymentMethods(context.TODO(), \"MH4H92C7\", sumup.CheckoutsListAvailablePaymentMethodsParams{\n\t\tAmount: new(float64(9.99)),\n\t\tCurrency: new(\"EUR\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetPerson", @@ -225,7 +225,7 @@ "description": "Returns a single Person related to a Merchant.", "httpMethod": "GET", "path": "/v1/merchants/{merchant_code}/persons/{person_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Merchants.GetPerson(ctx, \"MK10CL2A\", \"pers_5AKFHN2KSK8D3TS79DJE3P3A2Z\", sumup.MerchantsGetPersonParams{\n\t\tVersion: ptr(\"latest\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Merchants.GetPerson(context.TODO(), \"MK10CL2A\", \"pers_5AKFHN2KSK8D3TS79DJE3P3A2Z\", sumup.MerchantsGetPersonParams{\n\t\tVersion: new(\"latest\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetReader", @@ -234,7 +234,7 @@ "description": "Retrieve a Reader.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.Get(ctx, \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersGetParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.Get(context.TODO(), \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersGetParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetReaderCheckout", @@ -243,7 +243,7 @@ "description": "Get a Checkout for a Reader.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}/checkout/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.GetCheckout(ctx, \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", \"74ecff66-1655-43ed-8ce3-193f49fa602f\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.GetCheckout(context.TODO(), \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", \"74ecff66-1655-43ed-8ce3-193f49fa602f\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetReaderStatus", @@ -252,7 +252,7 @@ "description": "Provides the last known status for a Reader.\n\nThis endpoint allows you to retrieve updates from the connected card reader, including the current screen being displayed during the payment process and the device status (battery level, connectivity, and update state).\n\nSupported States\n\n* `IDLE` – Reader ready for next transaction\n* `SELECTING_TIP` – Waiting for tip input\n* `WAITING_FOR_CARD` – Awaiting card insert/tap\n* `WAITING_FOR_PIN` – Waiting for PIN entry\n* `WAITING_FOR_SIGNATURE` – Waiting for customer signature\n* `UPDATING_FIRMWARE` – Firmware update in progress\n\nDevice Status\n\n* `ONLINE` – Device connected and operational\n* `OFFLINE` – Device disconnected (last state persisted)\n\n**Note**: If the target device is a Solo, it must be in version 3.3.39.0 or higher.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}/status", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.GetStatus(ctx, \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.GetStatus(context.TODO(), \"MC0X0ABC\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetReceipt", @@ -261,7 +261,7 @@ "description": "Retrieves receipt specific data for a transaction.", "httpMethod": "GET", "path": "/v1.1/receipts/{transaction_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Receipts.Get(ctx, \"string\", sumup.ReceiptsGetParams{\n\t\tMid: \"string\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Receipts.Get(context.TODO(), \"410fc44a-5956-44e1-b5cc-19c6f8d727a4\", sumup.ReceiptsGetParams{\n\t\tMid: \"MH4H92C7\",\n\t\tTxEventID: new(9567461191),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "GetTransactionV2.1", @@ -270,7 +270,7 @@ "description": "Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required:\n- `id`\n- `transaction_code`\n- `foreign_transaction_id`\n- `client_transaction_id`", "httpMethod": "GET", "path": "/v2.1/merchants/{merchant_code}/transactions", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Transactions.Get(ctx, \"MH4H92C7\", sumup.TransactionsGetParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Transactions.Get(context.TODO(), \"MH4H92C7\", sumup.TransactionsGetParams{\n\t\tID: new(\"410fc44a-5956-44e1-b5cc-19c6f8d727a4\"),\n\t\tTransactionCode: new(\"TEENSK4W2K\"),\n\t\tForeignTransactionID: new(\"J13253253x1\"),\n\t\tClientTransactionID: new(\"urn:sumup:pos:sale:MNKKNGST:1D4E3B2D-111D-48D7-9AF0-832DAEF63DD7;2\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListCheckouts", @@ -279,7 +279,7 @@ "description": "Lists created checkout resources according to the applied `checkout_reference`.", "httpMethod": "GET", "path": "/v0.1/checkouts", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.List(ctx, sumup.CheckoutsListParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.List(context.TODO(), sumup.CheckoutsListParams{\n\t\tCheckoutReference: new(\"f00a8f74-b05d-4605-bd73-2a901bae5802\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListMemberships", @@ -288,7 +288,7 @@ "description": "List memberships of the current user.", "httpMethod": "GET", "path": "/v0.1/memberships", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Memberships.List(ctx, sumup.MembershipsListParams{\n\t\tOffset: ptr(0),\n\t\tLimit: ptr(10),\n\t\tKind: ptr(sumup.ResourceType(\"merchant\")),\n\t\tStatus: ptr(sumup.MembershipStatus(\"accepted\")),\n\t\tResourceType: ptr(sumup.ResourceType(\"merchant\")),\n\t\tRoles: []string{\"role_employee\", \"role_accountant\"},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Memberships.List(context.TODO(), sumup.MembershipsListParams{\n\t\tOffset: new(0),\n\t\tLimit: new(10),\n\t\tKind: new(sumup.ResourceType(\"merchant\")),\n\t\tStatus: new(sumup.MembershipStatus(\"accepted\")),\n\t\tResourceType: new(sumup.ResourceType(\"merchant\")),\n\t\tRoles: []string{\"role_employee\", \"role_accountant\"},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListMerchantMembers", @@ -297,7 +297,7 @@ "description": "Lists merchant members.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/members", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Members.List(ctx, \"MK10CL2A\", sumup.MembersListParams{\n\t\tOffset: ptr(0),\n\t\tLimit: ptr(10),\n\t\tScroll: ptr(true),\n\t\tEmail: ptr(\"user\"),\n\t\tUserID: ptr(\"245b2ead-85bf-45ff-856f-311a88a5d454\"),\n\t\tStatus: ptr(sumup.MembershipStatus(\"accepted\")),\n\t\tRoles: []string{\"role_employee\", \"role_accountant\"},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Members.List(context.TODO(), \"MK10CL2A\", sumup.MembersListParams{\n\t\tOffset: new(0),\n\t\tLimit: new(10),\n\t\tScroll: new(true),\n\t\tEmail: new(\"user\"),\n\t\tUserID: new(\"245b2ead-85bf-45ff-856f-311a88a5d454\"),\n\t\tStatus: new(sumup.MembershipStatus(\"accepted\")),\n\t\tRoles: []string{\"role_employee\", \"role_accountant\"},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListMerchantRoles", @@ -306,7 +306,7 @@ "description": "List merchant's custom roles.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/roles", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Roles.List(ctx, \"MK10CL2A\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Roles.List(context.TODO(), \"MK10CL2A\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListPaymentInstruments", @@ -315,7 +315,7 @@ "description": "Lists all payment instrument resources that are saved for an identified customer.", "httpMethod": "GET", "path": "/v0.1/customers/{customer_id}/payment-instruments", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Customers.ListPaymentInstruments(ctx, \"string\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Customers.ListPaymentInstruments(context.TODO(), \"831ff8d4cd5958ab5670\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListPayoutsV1", @@ -324,7 +324,7 @@ "description": "Lists payout and payout-deduction records for the specified merchant account within the requested date range.\n\nThe response can include:\n- regular payouts (`type = PAYOUT`)\n- deduction records for refunds, chargebacks, direct debit returns, or balance adjustments\n\nResults are sorted by payout date in the requested `order`.", "httpMethod": "GET", "path": "/v1.0/merchants/{merchant_code}/payouts", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/datetime\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Payouts.List(ctx, \"MH4H92C7\", sumup.PayoutsListParams{\n\t\tStartDate: datetime.NewDate(2024, time.February, 1),\n\t\tEndDate: datetime.NewDate(2024, time.February, 29),\n\t\tFormat: ptr(sumup.PayoutsListFormat(\"json\")),\n\t\tLimit: ptr(10),\n\t\tOrder: ptr(sumup.PayoutsListOrder(\"desc\")),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/datetime\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Payouts.List(context.TODO(), \"MH4H92C7\", sumup.PayoutsListParams{\n\t\tStartDate: datetime.NewDate(2024, time.February, 1),\n\t\tEndDate: datetime.NewDate(2024, time.February, 29),\n\t\tFormat: new(sumup.PayoutsListFormat(\"json\")),\n\t\tLimit: new(10),\n\t\tOrder: new(sumup.PayoutsListOrder(\"desc\")),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListPersons", @@ -333,7 +333,7 @@ "description": "Returns the Persons related to a Merchant.", "httpMethod": "GET", "path": "/v1/merchants/{merchant_code}/persons", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Merchants.ListPersons(ctx, \"MK10CL2A\", sumup.MerchantsListPersonsParams{\n\t\tVersion: ptr(\"latest\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Merchants.ListPersons(context.TODO(), \"MK10CL2A\", sumup.MerchantsListPersonsParams{\n\t\tVersion: new(\"latest\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListReaders", @@ -342,7 +342,7 @@ "description": "List all readers of the merchant.", "httpMethod": "GET", "path": "/v0.1/merchants/{merchant_code}/readers", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.List(ctx, \"MK10CL2A\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.List(context.TODO(), \"MK10CL2A\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "ListTransactionsV2.1", @@ -351,57 +351,7 @@ "description": "Lists detailed history of all transactions associated with the merchant profile.", "httpMethod": "GET", "path": "/v2.1/merchants/{merchant_code}/transactions/history", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Transactions.List(ctx, \"MH4H92C7\", sumup.TransactionsListParams{\n\t\tOrder: ptr(sumup.TransactionsListOrder(\"ascending\")),\n\t\tUsers: []string{\"merchant@example.com\"},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" - }, - { - "id": "ProcessCheckout.ProcessBancontact", - "operationId": "ProcessCheckout", - "example": "ProcessBancontact", - "summary": "Process a checkout", - "description": "Process a checkout with Bancontact", - "httpMethod": "PUT", - "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Process(ctx, \"string\", sumup.CheckoutsProcessParams{\n\t\tPaymentType: \"bancontact\",\n\t\tPersonalDetails: ptr(sumup.PersonalDetails{\n\t\t\tAddress: ptr(sumup.AddressLegacy{\n\t\t\t\tCountry: ptr(\"BE\"),\n\t\t\t}),\n\t\t\tEmail: ptr(\"user@example.com\"),\n\t\t\tFirstName: ptr(\"John\"),\n\t\t\tLastName: ptr(\"Doe\"),\n\t\t}),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" - }, - { - "id": "ProcessCheckout.ProcessBoleto", - "operationId": "ProcessCheckout", - "example": "ProcessBoleto", - "summary": "Process a checkout", - "description": "Process a checkout with Boleto", - "httpMethod": "PUT", - "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Process(ctx, \"string\", sumup.CheckoutsProcessParams{\n\t\tPaymentType: \"boleto\",\n\t\tPersonalDetails: ptr(sumup.PersonalDetails{\n\t\t\tAddress: ptr(sumup.AddressLegacy{\n\t\t\t\tCity: ptr(\"São Paulo\"),\n\t\t\t\tCountry: ptr(\"BR\"),\n\t\t\t\tPostalCode: ptr(\"05425-020\"),\n\t\t\t\tState: ptr(\"SP\"),\n\t\t\t}),\n\t\t\tEmail: ptr(\"user@example.com\"),\n\t\t\tFirstName: ptr(\"John\"),\n\t\t\tLastName: ptr(\"Doe\"),\n\t\t\tTaxID: ptr(\"423.378.593-47\"),\n\t\t}),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" - }, - { - "id": "ProcessCheckout.ProcessCard", - "operationId": "ProcessCheckout", - "example": "ProcessCard", - "summary": "Process a checkout", - "description": "Process a checkout with a card", - "httpMethod": "PUT", - "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Process(ctx, \"string\", sumup.CheckoutsProcessParams{\n\t\tCard: ptr(sumup.Card{\n\t\t\tCvv: \"123\",\n\t\t\tExpiryMonth: \"01\",\n\t\t\tExpiryYear: \"2023\",\n\t\t\tName: \"John Doe\",\n\t\t\tNumber: \"1234567890123456\",\n\t\t\tType: \"VISA\",\n\t\t\tZipCode: ptr(\"12345\"),\n\t\t}),\n\t\tInstallments: ptr(1),\n\t\tMandate: ptr(sumup.MandatePayload{\n\t\t\tType: \"recurrent\",\n\t\t\tUserAgent: \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.104 Safari/537.36\",\n\t\t\tUserIP: ptr(\"172.217.169.174\"),\n\t\t}),\n\t\tPaymentType: \"card\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" - }, - { - "id": "ProcessCheckout.ProcessToken", - "operationId": "ProcessCheckout", - "example": "ProcessToken", - "summary": "Process a checkout", - "description": "Process a checkout with a token", - "httpMethod": "PUT", - "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Process(ctx, \"string\", sumup.CheckoutsProcessParams{\n\t\tCustomerID: ptr(\"MEDKHDTI\"),\n\t\tInstallments: ptr(1),\n\t\tPaymentType: \"card\",\n\t\tToken: ptr(\"ba85dfee-c3cf-48a6-84f5-d7d761fbba50\"),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" - }, - { - "id": "ProcessCheckout.ProcessiDeal", - "operationId": "ProcessCheckout", - "example": "ProcessiDeal", - "summary": "Process a checkout", - "description": "Process a checkout with iDeal", - "httpMethod": "PUT", - "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Process(ctx, \"string\", sumup.CheckoutsProcessParams{\n\t\tPaymentType: \"ideal\",\n\t\tPersonalDetails: ptr(sumup.PersonalDetails{\n\t\t\tAddress: ptr(sumup.AddressLegacy{\n\t\t\t\tCountry: ptr(\"NL\"),\n\t\t\t}),\n\t\t\tEmail: ptr(\"user@example.com\"),\n\t\t\tFirstName: ptr(\"John\"),\n\t\t\tLastName: ptr(\"Doe\"),\n\t\t}),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Transactions.List(context.TODO(), \"MH4H92C7\", sumup.TransactionsListParams{\n\t\tTransactionCode: new(\"TEENSK4W2K\"),\n\t\tOrder: new(sumup.TransactionsListOrder(\"ascending\")),\n\t\tLimit: new(10),\n\t\tUsers: []string{\"merchant@example.com\"},\n\t\tStatuses: []sumup.TransactionsListStatusesItem{\"SUCCESSFUL\", \"REFUNDED\"},\n\t\tPaymentTypes: []sumup.PaymentType{\"ECOM\", \"POS\"},\n\t\tEntryModes: []sumup.EntryMode{\"CUSTOMER_ENTRY\", \"CHIP\"},\n\t\tTypes: []sumup.TransactionsListTypesItem{\"PAYMENT\", \"REFUND\"},\n\t\tChangesSince: new(time.Date(2019, time.August, 28, 9, 0, 0, 0, time.UTC)),\n\t\tNewestTime: new(time.Date(2019, time.August, 29, 9, 0, 0, 0, time.UTC)),\n\t\tNewestRef: new(\"090df9bf-93b7-40f1-8181-fbdb236568a1\"),\n\t\tOldestTime: new(time.Date(2019, time.August, 28, 9, 0, 0, 0, time.UTC)),\n\t\tOldestRef: new(\"090df9bf-93b7-40f1-8181-fbdb236568a1\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "RefundTransaction", @@ -410,7 +360,7 @@ "description": "Refunds an identified transaction either in full or partially.", "httpMethod": "POST", "path": "/v1.0/merchants/{merchant_code}/payments/{transaction_id}/refunds", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Transactions.Refund(ctx, \"MH4H92C7\", \"string\", sumup.TransactionsRefundParams{\n\t\tAmount: ptr(float32(5)),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Transactions.Refund(context.TODO(), \"MH4H92C7\", \"4ffb8dfc-7f2b-413d-a497-2ad00766585e\", sumup.TransactionsRefundParams{\n\t\tAmount: new(float32(5)),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "UpdateCheckout", @@ -419,7 +369,7 @@ "description": "Updates an identified checkout resource.", "httpMethod": "PATCH", "path": "/v0.1/checkouts/{checkout_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/nullable\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Checkouts.Update(ctx, \"string\", sumup.CheckoutsUpdateParams{\n\t\tAmount: ptr(float32(12.5)),\n\t\tCheckoutReference: ptr(\"f00a8f74-b05d-4605-bd73-2a901bae5802\"),\n\t\tCurrency: ptr(sumup.Currency(\"EUR\")),\n\t\tCustomerID: ptr(\"831ff8d4cd5958ab5670\"),\n\t\tDescription: ptr(\"Updated purchase\"),\n\t\tValidUntil: nullable.Value(mustParseTime(\"2020-02-29T10:56:56+00:00\")),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n\nfunc mustParseTime(value string) time.Time {\n\tparsed, err := time.Parse(time.RFC3339, value)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treturn parsed\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"time\"\n\n\t\"github.com/sumup/sumup-go\"\n\t\"github.com/sumup/sumup-go/nullable\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Checkouts.Update(context.TODO(), \"4e425463-3e1b-431d-83fa-1e51c2925e99\", sumup.CheckoutsUpdateParams{\n\t\tAmount: new(float32(12.5)),\n\t\tCheckoutReference: new(\"f00a8f74-b05d-4605-bd73-2a901bae5802\"),\n\t\tCurrency: new(sumup.Currency(\"EUR\")),\n\t\tCustomerID: new(\"831ff8d4cd5958ab5670\"),\n\t\tDescription: new(\"Updated purchase\"),\n\t\tValidUntil: nullable.Value(time.Date(2020, time.February, 29, 10, 56, 56, 0, time.UTC)),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "UpdateCustomer", @@ -428,7 +378,7 @@ "description": "Updates an identified saved customer resource's personal details.\n\nThe request only overwrites the parameters included in the request, all other parameters will remain with their initially assigned values.", "httpMethod": "PUT", "path": "/v0.1/customers/{customer_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Customers.Update(ctx, \"string\", sumup.CustomersUpdateParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Customers.Update(context.TODO(), \"831ff8d4cd5958ab5670\", sumup.CustomersUpdateParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "UpdateMerchantMember", @@ -437,7 +387,7 @@ "description": "Update the merchant member.", "httpMethod": "PUT", "path": "/v0.1/merchants/{merchant_code}/members/{member_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Members.Update(ctx, \"MK10CL2A\", \"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\", sumup.MembersUpdateParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Members.Update(context.TODO(), \"MK10CL2A\", \"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\", sumup.MembersUpdateParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "UpdateMerchantRole", @@ -446,7 +396,7 @@ "description": "Update a custom role.", "httpMethod": "PATCH", "path": "/v0.1/merchants/{merchant_code}/roles/{role_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Roles.Update(ctx, \"MK10CL2A\", \"role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\", sumup.RolesUpdateParams{\n\t\tName: ptr(\"Senior Shop Manager III\"),\n\t\tPermissions: []string{\"catalog_edit\", \"taxes_access\", \"members_edit\"},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Roles.Update(context.TODO(), \"MK10CL2A\", \"role_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP\", sumup.RolesUpdateParams{\n\t\tName: new(\"Senior Shop Manager III\"),\n\t\tPermissions: []string{\"catalog_edit\", \"taxes_access\", \"members_edit\"},\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" }, { "id": "UpdateReader", @@ -455,7 +405,7 @@ "description": "Update a Reader.", "httpMethod": "PATCH", "path": "/v0.1/merchants/{merchant_code}/readers/{reader_id}", - "sample": "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient := sumup.NewClient()\n\n\tresult, err := client.Readers.Update(ctx, \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersUpdateParams{\n\t\tMetadata: sumup.Metadata{},\n\t\tName: ptr(sumup.ReaderName(\"Frontdesk\")),\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tlog.Printf(\"%+v\", result)\n}\n\nfunc ptr[T any](value T) *T {\n\treturn \u0026value\n}\n" + "sample": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/sumup/sumup-go\"\n)\n\nfunc main() {\n\tclient := sumup.NewClient()\n\tresult, err := client.Readers.Update(context.TODO(), \"MK10CL2A\", \"rdr_3MSAFM23CK82VSTT4BN6RWSQ65\", sumup.ReadersUpdateParams{\n\t\tMetadata: sumup.Metadata{},\n\t\tName: new(sumup.ReaderName(\"Frontdesk\")),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\n\tfmt.Printf(\"%+v\\n\", result)\n}\n" } ] }