> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkesta.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Setcard

> Setcard APM ile ödeme alma

## Setcard - APM ile Ödeme Alma

**`POST`** `https://api-test.fincraft.com.tr/api/v1/payments/apm-methods/auth`

<Info>
  Servis üzerinden HTML değer sonucu olarak verilir. Kullanıcı HTML üzerinden işlemi tamamladıktan sonra `callbackUrl` üzerinden işlem sonucu alınır.
</Info>

## Request Body

```json theme={null}
{
    "apmType": "SETCARD",
    "referenceId": "{{$guid}}",
    "callbackUrl": "https://www.deneme.com",
    "amount": 5,
    "currency": "TRY",
    "clientIp": "185.1.2.3",
    "products": [
        {
            "name": "Test ürün",
            "externalId": "SKU-001",
            "price": 5
        }
    ]
}
```

## Request Parametreleri

| Parametre     | Tip     | Zorunlu | Açıklama                                   |
| ------------- | ------- | ------- | ------------------------------------------ |
| `apmType`     | String  | Evet    | `SETCARD`                                  |
| `callbackUrl` | String  | Evet    | İşlem sonucunun bildirildiği adres (https) |
| `referenceId` | String  | Evet    | Benzersiz referans ID                      |
| `amount`      | Decimal | Evet    | Toplam işlem tutarı                        |
| `currency`    | String  | Evet    | Para birimi                                |
| `clientIp`    | String  | Evet    | IP adresi                                  |

## Response

HTML dönüş yapılır.

## Resolve

Eğerki callbackUrl'e işlem iletilemez ise `/api/v1/payments/apm-methods/resolve`:

```json theme={null}
{"referenceId": "33d47b3e-d5d2-421f-b72d-3810692bcea7"}
```