MaxiPago 3.0.25
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package MaxiPago --version 3.0.25
NuGet\Install-Package MaxiPago -Version 3.0.25
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MaxiPago" Version="3.0.25" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MaxiPago --version 3.0.25
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: MaxiPago, 3.0.25"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install MaxiPago as a Cake Addin
#addin nuget:?package=MaxiPago&version=3.0.25
// Install MaxiPago as a Cake Tool
#tool nuget:?package=MaxiPago&version=3.0.25
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
MaxiPago SDK client
The MaxiPago gateway SDK for .NET projects
CI/CD
Build status | Last commit | Tests | Coverage | Code Smells | LoC |
---|---|---|---|---|---|
Code Quality (main branch)
Installation
Github Releases
Download the latest zip file from the Release page.
Nuget package manager
Package | Version | Downloads |
---|---|---|
MaxiPago |
Features
Implements all features of MaxiPago API available at Integration Documentation
- Add customer
- Delete customer
- Update customer
- Add card on file
- Delete card on file
- Cancel recurring
- Sale (with card data)
- Sale (with saved card)
- Sale (with card data, saving the card for future use)
- Auth (with card data)
- Auth (with saved card)
- Auth (with card data, saving the card for future use)
- Boleto (bank slip / bank bill - Brazil only!)
- Capture (capture a pre auth request)
- Return
- Void
- Recurring (with card data)
- Recurring (with saved card)
- Online Debit (Brazil only!)
- Transactions report
- Transaction detailed report
- Transaction detailed report by order id
- Check request status
Usage
Adding a customer
//For each environment (TEST and LIVE) this information is different!
var merchantId = "your-merchant-id"; //get this information with MaxiPago
var merchantKey = "your-merchant-key"; //get this information with MaxiPago
var api = new Api { Environment = "TEST" }; //TEST or LIVE
var response = api.AddConsumer(
MerchantId,
MerchantKey,
userIdInYourSystem,
firstName,
lastName,
addressLineOne, //if you don't has this information, use null instead
addressLineTwo, //if you don't has this information, use null instead
city, //if you don't has this information, use null instead
state, //if you don't has this information, use null instead
zipCode, //if you don't has this information, use null instead
phone, //if you don't has this information, use null instead
email,
dateOfBirth, //if you don't has this information, use null instead
document,
gender); //M for Male and F for Female
if(!string.IsNullOrWhiteSpace(response.ErrorMessage))
//handle the error message.
return response.Result.CustomerId; //store this customer id value for update or delete the customer in future.
Delete customer
//For each environment (TEST and LIVE) this information is different!
var merchantId = "your-merchant-id"; //get this information with MaxiPago
var merchantKey = "your-merchant-key"; //get this information with MaxiPago
var api = new Api { Environment = "TEST" }; //TEST or LIVE
var response = api.DeleteCustomer(merchantId, merchantKey, customerId); //this information was returned by the AddCustomer method.
if(!string.IsNullOrWhiteSpace(response.ErrorMessage))
//handle the error message.
Update customer
//For each environment (TEST and LIVE) this information is different!
var merchantId = "your-merchant-id"; //get this information with MaxiPago
var merchantKey = "your-merchant-key"; //get this information with MaxiPago
var api = new Api { Environment = "TEST" }; //TEST or LIVE
var response = api.UpdatedCustomer(
merchantId,
merchantKey,
customerId,
userIdOnYourSystem,
firstName,
lastName,
null,
null,
null,
null,
null,
"+5511123456789", //updates the telephone
email,
null,
null,
"M");
if(!string.IsNullOrWhiteSpace(response.ErrorMessage))
//handle the error message.
Save card
//For each environment (TEST and LIVE) this information is different!
var merchantId = "your-merchant-id"; //get this information with MaxiPago
var merchantKey = "your-merchant-key"; //get this information with MaxiPago
var api = new Api { Environment = "TEST" }; //TEST or LIVE
var response = api.AddCardOnFile(
merchantId,
merchantKey,
customerId,
creditCardNumber,
expirationMonth,
expirationYear,
billingName,
billingAddressLineOne,
billingAddressLineTwo,
billingCity,
billingState,
billingZip,
billingCountry,
billingPhone,
billingEmail,
onFileEndDate, //Deadline to keep the card in the base
onFilePermission, //Limit duration for the use of the saved card. "ongoing" = indefinitely / "use_once" = only once after the 1st payment
onFileComment,
onFileMaxChargeAmount); //Maximum amount that this card is authorized to be charged.
if(!string.IsNullOrWhiteSpace(response.ErrorMessage))
//handle the error message.
return response.Result.Token; //store this token for future use (remove card, sale, auth...)
Create recurring payment
//For each environment (TEST and LIVE) this information is different!
var merchantId = "your-merchant-id"; //get this information with MaxiPago
var merchantKey = "your-merchant-key"; //get this information with MaxiPago
var transaction = new Transaction { Environment = "TEST" }; //TEST or LIVE
var response = transaction.Recurring(
merchantId,
merchantKey,
transactionId,
value,
creditCardNumber,
expirationMonth,
expirationYear,
null,
creditCardSecureCode,
processorId, //TEST SIMULATOR = 1 | Rede = 2 | GetNet = 3 | Cielo = 4 | TEF = 5 | Elavon = 6 | ChasePaymentech = 8
6, //installments
"N", //charge interest
ipAddress,
"new",
startDate, //the date of first charge
frequency, //combined with period, so if frequency is 1, every "period" will be charged. So if period is "weekly" and frequency is "2", every two weeks will be charged.
period, //The charge recurring period: daily, weekly, monthly
numberOfTimes, //The number of times to repeat the charge (use 999 as max value for "indefinitely" time, after 999 times, this recurring will need to be created again).
failureThreshold, //Number of failed attempts needed to trigger email notification to merchant.
"BRL"); //currency of the charge.
if(response.IsErrorResponse){
if(response is ErrorResponse errorResult)
Console.WriteLine(errorResult.ErrorMsg); //handle the error message.
}
if(!(response is TransactionResponse result))
//some other erro, handle it
var orderId = result.OrderId;
var responseCode = result.ResponseCode;
if(responseCode != 0) {
Console.WriteLine(result.ErrorMessage); //handle it
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- Microsoft.AspNet.WebApi.Client (>= 5.2.9)
- Newtonsoft.Json (>= 13.0.3)
-
.NETStandard 2.1
- Microsoft.AspNet.WebApi.Client (>= 5.2.9)
- Newtonsoft.Json (>= 13.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
3.0.454 | 67 | 4/30/2024 |
3.0.451 | 73 | 4/30/2024 |
3.0.444 | 73 | 4/29/2024 |
3.0.435 | 62 | 4/22/2024 |
3.0.432 | 67 | 4/22/2024 |
3.0.427 | 71 | 4/22/2024 |
3.0.422 | 83 | 4/15/2024 |
3.0.419 | 86 | 4/15/2024 |
3.0.414 | 82 | 4/8/2024 |
3.0.411 | 150 | 3/18/2024 |
3.0.408 | 170 | 2/26/2024 |
3.0.405 | 186 | 2/20/2024 |
3.0.401 | 200 | 2/19/2024 |
3.0.389 | 208 | 2/14/2024 |
3.0.386 | 187 | 2/14/2024 |
3.0.380 | 200 | 2/12/2024 |
3.0.377 | 188 | 2/12/2024 |
3.0.372 | 283 | 1/30/2024 |
3.0.369 | 240 | 1/29/2024 |
3.0.364 | 248 | 1/29/2024 |
3.0.356 | 263 | 1/22/2024 |
3.0.353 | 271 | 1/22/2024 |
3.0.350 | 275 | 1/22/2024 |
3.0.343 | 271 | 1/16/2024 |
3.0.340 | 279 | 1/16/2024 |
3.0.335 | 307 | 1/15/2024 |
3.0.328 | 303 | 1/8/2024 |
3.0.325 | 303 | 12/25/2023 |
3.0.322 | 282 | 12/25/2023 |
3.0.317 | 336 | 12/18/2023 |
3.0.297 | 356 | 12/14/2023 |
3.0.291 | 345 | 12/11/2023 |
3.0.288 | 340 | 12/11/2023 |
3.0.283 | 344 | 12/11/2023 |
3.0.280 | 370 | 12/11/2023 |
3.0.271 | 394 | 12/4/2023 |
3.0.268 | 396 | 12/4/2023 |
3.0.263 | 333 | 11/27/2023 |
3.0.260 | 315 | 11/20/2023 |
3.0.255 | 350 | 11/20/2023 |
3.0.250 | 345 | 11/20/2023 |
3.0.243 | 362 | 11/14/2023 |
3.0.238 | 364 | 11/14/2023 |
3.0.235 | 309 | 11/13/2023 |
3.0.230 | 280 | 11/9/2023 |
3.0.224 | 290 | 11/6/2023 |
3.0.221 | 334 | 11/6/2023 |
3.0.216 | 369 | 10/30/2023 |
3.0.213 | 371 | 10/30/2023 |
3.0.206 | 420 | 10/23/2023 |
3.0.203 | 368 | 10/16/2023 |
3.0.200 | 381 | 10/16/2023 |
3.0.195 | 379 | 10/16/2023 |
3.0.188 | 379 | 10/8/2023 |
3.0.179 | 413 | 9/23/2023 |
3.0.176 | 432 | 9/19/2023 |
3.0.173 | 474 | 9/19/2023 |
3.0.168 | 428 | 9/19/2023 |
3.0.152 | 434 | 9/12/2023 |
3.0.149 | 469 | 9/12/2023 |
3.0.144 | 448 | 9/4/2023 |
3.0.141 | 483 | 8/24/2023 |
3.0.138 | 469 | 8/14/2023 |
3.0.135 | 510 | 8/14/2023 |
3.0.132 | 448 | 8/14/2023 |
3.0.123 | 492 | 8/14/2023 |
3.0.118 | 462 | 8/8/2023 |
3.0.115 | 499 | 7/23/2023 |
3.0.112 | 468 | 7/23/2023 |
3.0.102 | 513 | 7/23/2023 |
3.0.98 | 492 | 7/23/2023 |
3.0.96 | 502 | 7/23/2023 |
3.0.76 | 459 | 7/19/2023 |
3.0.70 | 532 | 7/14/2023 |
3.0.65 | 493 | 7/14/2023 |
3.0.62 | 474 | 7/13/2023 |
3.0.59 | 528 | 7/11/2023 |
3.0.56 | 421 | 7/11/2023 |
3.0.51 | 508 | 7/3/2023 |
3.0.48 | 476 | 6/19/2023 |
3.0.47 | 531 | 6/15/2023 |
3.0.44 | 465 | 6/5/2023 |
3.0.43 | 486 | 6/5/2023 |
3.0.40 | 454 | 6/5/2023 |
3.0.35 | 479 | 5/22/2023 |
3.0.32 | 472 | 5/22/2023 |
3.0.25 | 487 | 5/4/2023 |
3.0.22 | 507 | 5/3/2023 |
3.0.17 | 591 | 4/8/2023 |
3.0.11 | 508 | 4/4/2023 |
3.0.6 | 705 | 3/26/2023 |
3.0.2 | 522 | 3/26/2023 |
2.0.95 | 584 | 3/26/2023 |
2.0.80 | 472 | 3/26/2023 |
2.0.73 | 551 | 3/26/2023 |
2.0.70 | 555 | 3/22/2023 |
2.0.65 | 645 | 3/5/2023 |
2.0.61 | 568 | 3/3/2023 |
2.0.58 | 574 | 3/3/2023 |
2.0.50 | 565 | 3/3/2023 |
2.0.0 | 592 | 2/27/2023 |
1.0.49 | 1,208 | 4/18/2020 |
1.0.41 | 867 | 4/18/2020 |
1.0.24 | 873 | 4/18/2020 |
Add support to .NET Standard 2.0