C# / .NET
Opinber C#/.NET SDK fyrir Cost+ greiðslugáttina
Opinber C#/.NET SDK fyrir Cost+ greiðslugáttina. Einfaldar HPP (Hosted Payment Page) áframsendingarflæði, HMAC farmundirritun og vefhook-staðfestingu.
Eiginleikar
- Núll ósjálfstæði — notar aðeins innbyggða
System.Text.JsonogSystem.Security.Cryptography - Miðar á .NET 8.0 með C# 12 eiginleikum (skrár, nafnasvæði með skráarsniði, mynstursamsvörun)
- Núllhæfar tilvísunargerðir virkar í gegn
- HMAC-SHA256 undirskriftargerð og sannprófun á stöðugum tíma
- Sjálfvirk snake_case/PascalCase kortlagning á milli API og SDK
- Webhook þáttun + API byggt á pöntunarstaðfestingu
- Alveg ósamstillt API yfirborð
Kröfur
- .NET 8.0 SDK eða nýrri
- Kostnaðar+ sölureikningur — dashboard.costplus.io
Uppsetning
dotnet add package NoPaynEða sem staðbundin verkefnaviðmiðun:
dotnet add reference path/to/src/NoPayn/NoPayn.csprojFljótleg byrjun
1. Frumstilla viðskiptavininn
using NoPayn;
using NoPayn.Models;
var nopayn = new NoPaynClient(new NoPaynConfig(
ApiKey: "your-api-key",
MerchantId: "your-project"
));2. Búðu til greiðslu og sendu til HPP
var result = await nopayn.GeneratePaymentUrlAsync(new CreateOrderParams
{
Amount = 1295, // €12.95 in cents
Currency = "EUR",
MerchantOrderId = "ORDER-001",
Description = "Premium Widget",
ReturnUrl = "https://shop.example.com/success",
FailureUrl = "https://shop.example.com/failure",
WebhookUrl = "https://shop.example.com/webhook",
Locale = "en-GB",
ExpirationPeriod = "PT30M",
});
// Redirect the customer
// result.OrderUrl → HPP (customer picks payment method)
// result.PaymentUrl → direct link to the first transaction's payment method
// result.Signature → HMAC-SHA256 for verification
// result.OrderId → NoPayn order UUID3. Meðhöndlaðu vefkrókinn
app.MapPost("/webhook", async (HttpContext ctx) =>
{
using var reader = new StreamReader(ctx.Request.Body);
var rawBody = await reader.ReadToEndAsync();
var verified = await nopayn.VerifyWebhookAsync(rawBody);
Console.WriteLine(verified.Order.Status); // "completed", "cancelled", etc.
Console.WriteLine(verified.IsFinal); // true when the order won't change
if (verified.Order.Status == "completed")
{
// Fulfil the order
}
return Results.Ok();
});API Tilvísun
new NoPaynClient(config, httpClient?)
| Parameter | Tegund | Áskilið | Sjálfgefið |
|---|---|---|---|
ApiKey | string | Já | — |
MerchantId | string | Já | — |
BaseUrl | string | Nei | https://api.nopayn.co.uk |
Hægt er að senda valfrjálsan HttpClient sem aðra breytu byggingaraðila fyrir sérsniðna HTTP meðhöndlun eða prófun.
client.CreateOrderAsync(params): Task<Order>
Býr til pöntun í gegnum POST /v1/orders/.
| Parameter | Tegund | Áskilið | Lýsing |
|---|---|---|---|
Amount | int | Já | Upphæð í ISO 4217 minnieiningu gjaldmiðilsins (til dæmis sent fyrir EUR) |
Currency | string | Já | ISO 4217 kóði (EUR, GBP, USD, NOK, SEK) |
MerchantOrderId | string? | Nei | Innri pöntunartilvísun þín |
Description | string? | Nei | Lýsing á pöntun |
ReturnUrl | string? | Nei | Tilvísun eftir vel heppnaða greiðslu |
FailureUrl | string? | Nei | Tilvísun við hætt við/rennur út/villu |
WebhookUrl | string? | Nei | Ósamstilltur tilkynningar um stöðubreytingar |
Locale | string? | Nei | HPP tungumál (en-GB, de-DE, nl-NL, osfrv.) |
PaymentMethods | IReadOnlyList<string>? | Nei | Sía HPP aðferðir |
ExpirationPeriod | string? | Nei | ISO 8601 tímalengd (PT30M) |
Greiðsluaðferðir í boði: credit-card, apple-pay, google-pay, vipps-mobilepay
client.GetOrderAsync(orderId): Task<Order>
Sækir pöntunarupplýsingar í gegnum GET /v1/orders/{id}/.
client.CreateRefundAsync(orderId, amount, description?): Task<Refund>
Gefur út fulla eða hluta endurgreiðslu í gegnum POST /v1/orders/{id}/refunds/.
client.GeneratePaymentUrlAsync(params): Task<PaymentUrlResult>
Þægindaaðferð sem býr til pöntun og skilar:
public record PaymentUrlResult(
string OrderId, // NoPayn order UUID
string OrderUrl, // HPP URL
string? PaymentUrl, // Direct payment URL (first transaction)
string Signature, // HMAC-SHA256 of amount:currency:orderId
Order Order // Full order object
);client.GenerateSignature(amount, currency, orderId): string
Býr til HMAC-SHA256 hex undirskrift.
client.VerifySignature(amount, currency, orderId, signature): bool
Stöðug staðfesting á HMAC-SHA256 undirskrift.
client.VerifyWebhookAsync(rawBody): Task<VerifiedWebhook>
Þýðir meginmál vefkróksins og hringir síðan í GET /v1/orders/{id}/ til að staðfesta raunverulega stöðu.
Sjálfstæð HMAC tól
using NoPayn;
var sig = NoPaynSignature.Generate("your-api-key", 1295, "EUR", "order-uuid");
var ok = NoPaynSignature.Verify("your-api-key", 1295, "EUR", "order-uuid", sig);Villumeðferð
using NoPayn.Exceptions;
try
{
await nopayn.CreateOrderAsync(new CreateOrderParams { Amount = 100, Currency = "EUR" });
}
catch (ApiException ex)
{
Console.Error.WriteLine(ex.StatusCode); // 401, 400, etc.
Console.Error.WriteLine(ex.ErrorBody); // Raw API error response
}
catch (NoPaynException ex)
{
Console.Error.WriteLine(ex.Message); // Network or parsing error
}| Undantekning | Lýsing |
|---|---|
NoPaynException | Grunnundantekning (net, þáttun) |
ApiException | HTTP villa frá API |
WebhookException | Ógilt vefhook farmur |
Pöntunarstöður
| Staða | Úrslitaleikur? | Lýsing |
|---|---|---|
new | Nei | Pöntun búin til |
processing | Nei | Greiðsla í gangi |
completed | Já | Greiðsla tókst - afhenda vörurnar |
cancelled | Já | Greiðsla felld niður af viðskiptavinum |
expired | Já | Greiðslutengillinn rann út á tíma |
error | Já | Tæknileg bilun |
Bestu starfsvenjur Webhook
- Staðfestu alltaf í gegnum API — hleðslutækið inniheldur aðeins pöntunarauðkenni, aldrei stöðuna.
VerifyWebhookAsync()á SDK gerir þetta sjálfkrafa. - ** Skilaðu HTTP 200** til að staðfesta móttöku. Allir aðrir kóðar kalla fram allt að 10 endurtilraunir (2 mínútna millibili).
- Taka í notkun varakönnun — fyrir pantanir eldri en 10 mínútur sem hafa ekki náð endanlega stöðu skaltu skoða
GetOrderAsync()sem öryggisnet. - Vertu sjálfráða — þú gætir fengið sama vefhook margoft.
Prófakort
Notaðu þessi kort í Cost+ prófunarham (sandkassavefsíða):
| Kort | Númer | Skýringar |
|---|---|---|
| Visa (árangur) | 4111 1111 1111 1111 | Hvaða CVV sem er |
| Mastercard (árangur) | 5544 3300 0003 7 | Hvaða CVV sem er |
| Visa (hafnað) | 4111 1111 1111 1105 | Heiðra ekki |
| Visa (ófullnægjandi fjármunir) | 4111 1111 1111 1151 | Ófullnægjandi fjármunir |
Notaðu hvaða fyrningardagsetningu sem er í framtíðinni og hvaða þriggja stafa CVC sem er.
Demo app
ASP.NET Core kynningarforrit sem byggir á Docker er innifalið í GitHub geymslunni til að prófa allt greiðsluflæðið.
Stuðningur
Þarftu aðstoð? Hafðu samband við þjónustudeild okkar á support@costplus.io.