Bhengu.Finance.Payments.Yoco 2.1.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package Bhengu.Finance.Payments.Yoco --version 2.1.0
                    


                    

                
NuGet\Install-Package Bhengu.Finance.Payments.Yoco -Version 2.1.0
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="Bhengu.Finance.Payments.Yoco" Version="2.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Bhengu.Finance.Payments.Yoco" Version="2.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Bhengu.Finance.Payments.Yoco" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Bhengu.Finance.Payments.Yoco --version 2.1.0
                    


                    

                
#r "nuget: Bhengu.Finance.Payments.Yoco, 2.1.0"
#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. 
#:package Bhengu.Finance.Payments.Yoco@2.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Bhengu.Finance.Payments.Yoco&version=2.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Bhengu.Finance.Payments.Yoco&version=2.1.0
                    


                            Install as a Cake Tool

Bhengu.Finance.Payments.Yoco

Yoco adapter for the Bhengu.Finance.Payments family — South Africa's largest local-merchant card acquirer. Server-to-server card charges, refunds, payouts, tokenisation (vaulted + SAQ-D raw card), 3-D Secure step-up, and settlement reconciliation via Yoco's Online REST API, behind the Bhengu canonical contracts.

Install

dotnet add package Bhengu.Finance.Payments.Yoco

What this package gives you

Contract Provider class Notes
IPaymentGatewayProvider YocoPaymentProvider Charge / refund / webhook verify
IPayoutProvider YocoPayoutProvider Merchant payouts
ITokenisationProvider YocoTokenisationProvider Read vaulted card tokens
IRawCardTokenisationProvider YocoRawCardTokenisationProvider SAQ-D — accepts raw PAN+CVV
IThreeDSecureProvider YocoThreeDSecureProvider SCA step-up flow
ISettlementProvider YocoSettlementProvider Reconciliation feed

Wiring

builder.Services.AddYocoPayments(builder.Configuration);

Bind options from Bhengu:Finance:Payments:Yoco:

{
  "Bhengu": {
    "Finance": {
      "Payments": {
        "Yoco": {
          "SecretKey": "sk_test_...",
          "WebhookSecret": "whsec_...",
          "BaseUrl": null         // optional override
        }
      }
    }
  }
}

Usage

[ApiController]
public class CheckoutController(
    [FromKeyedServices(ProviderNames.Yoco)] IPaymentGatewayProvider gateway) : ControllerBase
{
    [HttpPost("charge")]
    public async Task<PaymentResponse> Charge([FromBody] PaymentRequest request)
        => await gateway.ProcessPaymentAsync(request);
}

PaymentRequest.PaymentMethodToken is a Yoco card token (e.g. tok_visa_...) from client-side tokenisation in Yoco's Web/Mobile SDK.

Capabilities at runtime

if (gateway.Capabilities.HasFlag(ProviderCapabilities.Refund))
    await gateway.ProcessRefundAsync(refundRequest);

if (gateway is IThreeDSecureProvider tds)
    var challenge = await tds.StartAuthenticationAsync(intent);

Status

For full SDK docs, observability wiring, resilience configuration and the family map see the main README.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Bhengu.Finance.Payments.Yoco:

Package Downloads
Bhengu.Finance.Payments.All

All Bhengu payment providers bundled together — install one package to get every provider in the Bhengu.Finance.Payments family.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.0 181 6/5/2026
2.0.0 140 6/5/2026
2.0.0-preview.8 87 6/5/2026
2.0.0-preview.7 82 6/4/2026
2.0.0-preview.6 87 6/4/2026
2.0.0-preview.5 82 6/4/2026