incoming-fasts

Operations addressed under /incoming-fasts — 8 operations.

get-incoming-fast-list

GET

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route declares its response as IEnumerable<IncomingFastDto>.

Field	Declared type	Nullable
`Id`	`Guid`	no
`FromCustomerId`	`Guid?`	yes
`PaymentPurpose`	`int?`	yes
`TransactionType`	`int?`	yes
`MessageType`	`int?`	yes
`ExternalSystemCode`	`string`	no
`QueryNumber`	`long?`	yes
`Amount`	`decimal?`	yes
`AuthorizedOwner`	`string`	no
`AuthorizedAccountId`	`Guid?`	yes
`AuthorizedIdentityNumber`	`string`	no
`AuthorizedAddress`	`string`	no
`AuthorizedCountryDistrict`	`string`	no
`AuthorizedBirthPlace`	`string`	no
`AuthorizedBirthDate`	`DateOnly?`	yes
`AuthorizedCustomerId`	`Guid?`	yes
`PaymentSource`	`string`	no
`FromParticipantCode`	`string`	no
`FromOwner`	`string`	no
`FromAccountId`	`Guid?`	yes
`FromIban`	`string`	no
`FromIdentityNumber`	`string`	no
`FromAddress`	`string`	no
`FromPassportNumber`	`string`	no
`FromBirthPlace`	`string`	no
`FromBirthDate`	`DateOnly?`	yes
`ToOwner`	`string`	no
`ToAccountId`	`Guid?`	yes
`ToIban`	`string`	no
`ToIdentityNumber`	`string`	no
`ReferenceInfo`	`string`	no
`Description`	`string`	no
`TransactionReference`	`string`	no
`StatusCode`	`string`	no
`AccountingEntryId`	`Guid?`	yes
`CancelAccountingEntryId`	`Guid?`	yes
`TransactionDate`	`DateTime?`	yes
`RefundCode`	`string`	no
`ConfirmCode`	`string`	no
`RefundQueryNumber`	`long?`	yes
`RefundTransactionDate`	`DateTime?`	yes
`RefundFromParticipantCode`	`string`	no
`ResponseCode`	`string`	no
`OutgoingFastId`	`Guid?`	yes

Member names are the service's declaration names.

get-incoming-fast-list › query Parameters

object

orderBy

string

orderSort

string

pageIndex

integer · int32

pageSize

integer · int32

get-incoming-fast-list › Responses

Success. Returns a collection of records. Of 135 operations in this state that were probed (measured against a reference deployment on parameterless GET routes only), 118 answered and 118 returned a bare JSON array.

object[]

Array of catalog-declared response records.

accountingEntryId

string · uuid

amount

number · decimal

authorizedAccountId

string · uuid

authorizedAddress

string

authorizedBirthDate

string · date

authorizedBirthPlace

string

authorizedCountryDistrict

string

authorizedCustomerId

string · uuid

authorizedIdentityNumber

string

authorizedOwner

string

cancelAccountingEntryId

string · uuid

confirmeCode

string

description

string

externalSystemCode

string

fromAccountId

string · uuid

fromAddress

string

fromBirthDate

string · date

fromBirthPlace

string

fromCustomerId

string · uuid

fromIban

string

fromIdentityNumber

fromOwner

string

fromParticipantCode

string

fromPassportNumber

string

id

string · uuid

messageType

string

Permitted values — validated against the message_type parameter. The service rejects any other value.

Value	Token	Labels
`1`	`A01-Instant Payment`	no label seeded
`2`	`M01-Customer Payment`	no label seeded
`3`	`A09-Payment Refund`	no label seeded
`4`	`H31-Refund Request`	no label seeded
`5`	`Payment Between Participants`	no label seeded
`6`	`Payment from Participant to TCMB`	no label seeded
`7`	`General Purpose Information`	no label seeded
`8`	`Balance Transfer Request`	no label seeded

paymentPurpose

integer · int32

Permitted values — validated against the payment_purpose parameter. The service rejects any other value.

Value	Token	Labels
`1`	`Residential Rent Payment`	en: Residential Rent Payment · tr: Konut Kirası Ödemesi · ar: دفع إيجار السكن
`2`	`Workplace Rent Payment`	en: Workplace Rent Payment · tr: İş Yeri Kirası Ödemesi · ar: دفع إيجار مكان العمل
`3`	`Other Rent Payment`	en: Other Rent Payment · tr: Diğer Kira Ödemesi · ar: دفعة إيجار أخرى
`4`	`E-Commerce Payment`	en: E-Commerce Payment · tr: E-Ticaret Ödemesi · ar: الدفع عبر التجارة الإلكترونية
`5`	`Salary Payment`	en: Salary Payment · tr: Maaş Ödemesi · ar: دفع الراتب
`6`	`Corporate Payment`	en: Individual Payment · tr: Bireysel Ödeme · ar: الدفع الفردي
`7`	`Individual Payment`	en: Investment · tr: Yatırım · ar: استثمار
`8`	`Investment`	en: Financial · tr: Finansal · ar: مالي
`9`	`Financial`	en: Education Payment · tr: Eğitim Ödemesi · ar: دفع التعليم
`10`	`Education Payment`	en: Membership Fee Payment · tr: Aidat Ödemesi · ar: دفع رسوم العضوية
`11`	`Membership Fee Payment`	en: Other · tr: Diğer · ar: آخر
`99`	`Others`	no label seeded

paymentSource

string

queryNumber

string

referenceInfo

string

refundCode

integer · int32

Permitted values — validated against the transfer_refund_code parameter. The service rejects any other value.

Value	Token	Labels
`1`	`Alıcı bilgileri eksik veya hatalı`	no label seeded
`2`	`Hesap numarası ile alıcı ismi uyumsuz`	no label seeded
`3`	`Hesap kapatılmış`	no label seeded
`4`	`Hesap numarası yanlış (örneğin, IBAN hesap numarasında hata var`	no label seeded
`5`	`Hesap EFT aktarımına uygun değil (örneğin, döviz hesabı)`	no label seeded
`6`	`İade İsteği mesajına istinaden iade`	no label seeded
`7`	`Mesajla gelen alıcı TCKN/VKN bilgisi katılımcıda ki kayıttan farklı`	no label seeded
`8`	`Gönderici bilgileri eksik ya da hatalı`	no label seeded
`9`	`IBAN’sız ödemelerde alıcı şube kodu hatalı`	no label seeded
`10`	`Hesap yalnızca iade mesajıyla yapılan ödemelere açık`	no label seeded
`11`	`Alıcı bilgileri ve hesap numarası bankamızda mevcut değil`	no label seeded
`99`	`Diğer nedenler`	no label seeded

statusCode

integer · int32

toAccountId

string · uuid

toIban

string

toIdentityNumber

toOwner

string

transactionDate

string · date

transactionReference

string

transactionType

integer · int32

Permitted values — validated against the transaction_type parameter. The service rejects any other value.

Value	Token	Labels
`1`	`QR`	no label seeded
`2`	`FAST`	no label seeded
`3`	`KOLAS`	no label seeded
`4`	`GOS`	no label seeded

GET/incoming-fasts

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts

Example Responses

[
  {
    "accountingEntryId": "00000000-0000-0000-0000-000000000000",
    "amount": 0,
    "authorizedAccountId": "00000000-0000-0000-0000-000000000000",
    "authorizedAddress": "authorizedAddress",
    "authorizedBirthDate": "2024-08-25",
    "authorizedBirthPlace": "authorizedBirthPlace",
    "authorizedCountryDistrict": "authorizedCountryDistrict",
    "authorizedCustomerId": "00000000-0000-0000-0000-000000000000",
    "authorizedIdentityNumber": "authorizedIdentityNumber",
    "authorizedOwner": "authorizedOwner",
    "cancelAccountingEntryId": "00000000-0000-0000-0000-000000000000",
    "confirmeCode": "confirmeCode",
    "description": "description",
    "externalSystemCode": "externalSystemCode",
    "fromAccountId": "00000000-0000-0000-0000-000000000000",
    "fromAddress": "fromAddress",
    "fromBirthDate": "2024-08-25",
    "fromBirthPlace": "fromBirthPlace",
    "fromCustomerId": "00000000-0000-0000-0000-000000000000",
    "fromIban": "fromIban",
    "fromIdentityNumber": {},
    "fromOwner": "fromOwner",
    "fromParticipantCode": "fromParticipantCode",
    "fromPassportNumber": "fromPassportNumber",
    "id": "00000000-0000-0000-0000-000000000000",
    "messageType": "messageType",
    "paymentPurpose": 0,
    "paymentSource": "paymentSource",
    "queryNumber": "queryNumber",
    "referenceInfo": "referenceInfo",
    "refundCode": 0,
    "statusCode": 0,
    "toAccountId": "00000000-0000-0000-0000-000000000000",
    "toIban": "toIban",
    "toIdentityNumber": {},
    "toOwner": "toOwner",
    "transactionDate": "2024-08-25",
    "transactionReference": "transactionReference",
    "transactionType": 0
  }
]

json

application/json

create-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route returns AuraCommandDto<Guid>, which is the response body itself and not a wrapper around one: the framework declares it as a class with a single property, Id, of type Guid. A caller gets a JSON OBJECT with one field, not a bare value. The field is id on the wire.

Field	Name on the wire	Declared type	Nullable
`Id`	`id`	`Guid`	no

Member names are the service's declaration names.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_12`	400	`TO_ACCOUNT_NOT_FOUND`	To Account Not Found
`ERR_MNYTRNS_14`	400	`TO_ACCOUNT_MUST_NOT_BE_PASSIVE`	To Account Must Not Be Passive
`ERR_MNYTRNS_66`	400	`ACOOUNT_HAS_CONSTRAINT`	Your money transfer transaction for the specified amount could not be completed because your daily EFT limit has been reached.

create-incoming-fast › Responses

Success. The catalog declares no response fields for this operation. The body is UNKNOWN CONTENT. The response type this route registers was read from the service's own source and is published on this operation as x-aura-code-response.

No data returned

complete-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/complete

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found
`ERR_MNYTRNS_24`	400	`INCOMING_FAST_NOT_ACTIVE`	Incoming Fast Not Active
`ERR_MNYTRNS_25`	400	`INCOMING_FAST_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Query Number Not Found
`ERR_MNYTRNS_30`	400	`INCOMING_FAST_RESULT_NOT_FOUND`	Incoming Fast Result Not Found
`ERR_MNYTRNS_33`	400	`INCOMING_FAST_RELATED_INFO_NOT_FOUND`	Incoming Fast Related Info Not Found
`ERR_MNYTRNS_34`	400	`INCOMING_FAST_RELATED_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Related Query Number Not Found

complete-incoming-fast › Request Body

fromParticipantCode

string · required

queryNumber

integer · int32 · required

object · required

result

integer · int32 · required

resultCode

integer · int32 · required

toParticipantCode

string · required

transactionDate

string · date · required

accountingEntryId

string · uuid

complete-incoming-fast › Responses

No data returned

POST/incoming-fasts/complete

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts/complete \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}'

Example Request Body

{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}

json

The field names and types this operation declares. Replace the values before sending.

application/json

Example Responses

No example specified for this content type

complete-refund-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/complete-refund

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_23`	400	`INCOMING_FAST_REFUND_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Refund Query Number Not Found
`ERR_MNYTRNS_46`	400	`INCOMING_FAST_REFUND_RELATED_INFO_NOT_FOUND`	Incoming fast refund related information not found.
`ERR_MNYTRNS_47`	400	`INCOMING_FAST_REFUND_RELATED_QUERY_NUMBER_NOT_FOUND`	Incoming fast refund related query number not found.
`ERR_MNYTRNS_49`	400	`INCOMING_FAST_REFUND_NOT_FOUND`	Incoming fast refund not found.
`ERR_MNYTRNS_51`	400	`INCOMING_FAST_REFUND_RESULT_NOT_FOUND`	Incoming fast refund result not found.
`ERR_MNYTRNS_52`	400	`INCOMING_FAST_REFUND_NOT_ACTIVE`	Incoming fast refund not active.

complete-refund-incoming-fast › Request Body

fromParticipantCode

string · required

queryNumber

integer · int32 · required

object · required

result

integer · int32 · required

resultCode

integer · int32 · required

toParticipantCode

string · required

transactionDate

string · date · required

accountingEntryId

string · uuid

complete-refund-incoming-fast › Responses

No data returned

POST/incoming-fasts/complete-refund

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts/complete-refund \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}'

Example Request Body

{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}

json

The field names and types this operation declares. Replace the values before sending.

application/json

Example Responses

No example specified for this content type

refund-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/refund

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route declares its response as RefundFastResponseDto.

Field	Declared type	Nullable
`ConfirmCode`	`int`	no
`ConfirmCodeDetail`	`int`	no

Member names are the service's declaration names.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_23`	400	`INCOMING_FAST_REFUND_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Refund Query Number Not Found
`ERR_MNYTRNS_46`	400	`INCOMING_FAST_REFUND_RELATED_INFO_NOT_FOUND`	Incoming fast refund related information not found.
`ERR_MNYTRNS_47`	400	`INCOMING_FAST_REFUND_RELATED_QUERY_NUMBER_NOT_FOUND`	Incoming fast refund related query number not found.
`ERR_MNYTRNS_48`	400	`INCOMING_FAST_REFUND_REFUND_CODE_NOT_FOUND`	Incoming fast refund refund code not found.

refund-incoming-fast › Request Body

amount

number · decimal · required

object · required

description

string · required

object · required

fromParticipantCode

string · required

queryNumber

integer · int32 · required

refundCode

string · required

Permitted values — validated against the transfer_refund_code parameter. The service rejects any other value.

Value	Token	Labels
`1`	`Alıcı bilgileri eksik veya hatalı`	no label seeded
`2`	`Hesap numarası ile alıcı ismi uyumsuz`	no label seeded
`3`	`Hesap kapatılmış`	no label seeded
`4`	`Hesap numarası yanlış (örneğin, IBAN hesap numarasında hata var`	no label seeded
`5`	`Hesap EFT aktarımına uygun değil (örneğin, döviz hesabı)`	no label seeded
`6`	`İade İsteği mesajına istinaden iade`	no label seeded
`7`	`Mesajla gelen alıcı TCKN/VKN bilgisi katılımcıda ki kayıttan farklı`	no label seeded
`8`	`Gönderici bilgileri eksik ya da hatalı`	no label seeded
`9`	`IBAN’sız ödemelerde alıcı şube kodu hatalı`	no label seeded
`10`	`Hesap yalnızca iade mesajıyla yapılan ödemelere açık`	no label seeded
`11`	`Alıcı bilgileri ve hesap numarası bankamızda mevcut değil`	no label seeded
`99`	`Diğer nedenler`	no label seeded

object · required

transactionDate

string · date · required

transactionReference

string · required

refund-incoming-fast › Responses

Success. An exact, uniquely bound route registration classifies this response as a single-record.

No data returned

POST/incoming-fasts/refund

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts/refund \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 0,
  "authorized": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "countryDistrict": "",
    "customerId": "",
    "identityNumber": "",
    "owner": ""
  },
  "description": "",
  "from": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "customerId": "",
    "iban": "",
    "identityNumber": "",
    "owner": "",
    "passportNumber": ""
  },
  "fromParticipantCode": "",
  "queryNumber": 0,
  "refundCode": "",
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "to": {
    "accountId": "",
    "iban": "",
    "identityNumber": "",
    "owner": ""
  },
  "transactionDate": "",
  "transactionReference": ""
}'

Example Request Body

{
  "amount": 0,
  "authorized": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "countryDistrict": "",
    "customerId": "",
    "identityNumber": "",
    "owner": ""
  },
  "description": "",
  "from": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "customerId": "",
    "iban": "",
    "identityNumber": "",
    "owner": "",
    "passportNumber": ""
  },
  "fromParticipantCode": "",
  "queryNumber": 0,
  "refundCode": "",
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "to": {
    "accountId": "",
    "iban": "",
    "identityNumber": "",
    "owner": ""
  },
  "transactionDate": "",
  "transactionReference": ""
}

json

The field names and types this operation declares. Replace the values before sending.

application/json

Example Responses

No example specified for this content type

get-incoming-fast-by-id

GET

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/{id}

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route declares its response as IncomingFastDto.

Field	Declared type	Nullable
`Id`	`Guid`	no
`FromCustomerId`	`Guid?`	yes
`PaymentPurpose`	`int?`	yes
`TransactionType`	`int?`	yes
`MessageType`	`int?`	yes
`ExternalSystemCode`	`string`	no
`QueryNumber`	`long?`	yes
`Amount`	`decimal?`	yes
`AuthorizedOwner`	`string`	no
`AuthorizedAccountId`	`Guid?`	yes
`AuthorizedIdentityNumber`	`string`	no
`AuthorizedAddress`	`string`	no
`AuthorizedCountryDistrict`	`string`	no
`AuthorizedBirthPlace`	`string`	no
`AuthorizedBirthDate`	`DateOnly?`	yes
`AuthorizedCustomerId`	`Guid?`	yes
`PaymentSource`	`string`	no
`FromParticipantCode`	`string`	no
`FromOwner`	`string`	no
`FromAccountId`	`Guid?`	yes
`FromIban`	`string`	no
`FromIdentityNumber`	`string`	no
`FromAddress`	`string`	no
`FromPassportNumber`	`string`	no
`FromBirthPlace`	`string`	no
`FromBirthDate`	`DateOnly?`	yes
`ToOwner`	`string`	no
`ToAccountId`	`Guid?`	yes
`ToIban`	`string`	no
`ToIdentityNumber`	`string`	no
`ReferenceInfo`	`string`	no
`Description`	`string`	no
`TransactionReference`	`string`	no
`StatusCode`	`string`	no
`AccountingEntryId`	`Guid?`	yes
`CancelAccountingEntryId`	`Guid?`	yes
`TransactionDate`	`DateTime?`	yes
`RefundCode`	`string`	no
`ConfirmCode`	`string`	no
`RefundQueryNumber`	`long?`	yes
`RefundTransactionDate`	`DateTime?`	yes
`RefundFromParticipantCode`	`string`	no
`ResponseCode`	`string`	no
`OutgoingFastId`	`Guid?`	yes

Member names are the service's declaration names.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found

get-incoming-fast-by-id › path Parameters

id

string · uuid · required

get-incoming-fast-by-id › Responses

Success. An exact, uniquely bound route registration classifies this response as a single-record.

No data returned

update-incoming-fast

PUT

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/{id}

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found

update-incoming-fast › path Parameters

id

string · required

Present in the route template but not declared as a Route-bound field in the catalog.

update-incoming-fast › Responses

No data returned

delete-incoming-fast

DELETE

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/{id}

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found

delete-incoming-fast › path Parameters

id

string · required

Present in the route template but not declared as a Route-bound field in the catalog.

delete-incoming-fast › Responses

No data returned

in-banks incoming-transfer

Money Transfer

incoming-fasts

Operations addressed under /incoming-fasts — 8 operations.

get-incoming-fast-list

GET

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route declares its response as IEnumerable<IncomingFastDto>.

Field	Declared type	Nullable
`Id`	`Guid`	no
`FromCustomerId`	`Guid?`	yes
`PaymentPurpose`	`int?`	yes
`TransactionType`	`int?`	yes
`MessageType`	`int?`	yes
`ExternalSystemCode`	`string`	no
`QueryNumber`	`long?`	yes
`Amount`	`decimal?`	yes
`AuthorizedOwner`	`string`	no
`AuthorizedAccountId`	`Guid?`	yes
`AuthorizedIdentityNumber`	`string`	no
`AuthorizedAddress`	`string`	no
`AuthorizedCountryDistrict`	`string`	no
`AuthorizedBirthPlace`	`string`	no
`AuthorizedBirthDate`	`DateOnly?`	yes
`AuthorizedCustomerId`	`Guid?`	yes
`PaymentSource`	`string`	no
`FromParticipantCode`	`string`	no
`FromOwner`	`string`	no
`FromAccountId`	`Guid?`	yes
`FromIban`	`string`	no
`FromIdentityNumber`	`string`	no
`FromAddress`	`string`	no
`FromPassportNumber`	`string`	no
`FromBirthPlace`	`string`	no
`FromBirthDate`	`DateOnly?`	yes
`ToOwner`	`string`	no
`ToAccountId`	`Guid?`	yes
`ToIban`	`string`	no
`ToIdentityNumber`	`string`	no
`ReferenceInfo`	`string`	no
`Description`	`string`	no
`TransactionReference`	`string`	no
`StatusCode`	`string`	no
`AccountingEntryId`	`Guid?`	yes
`CancelAccountingEntryId`	`Guid?`	yes
`TransactionDate`	`DateTime?`	yes
`RefundCode`	`string`	no
`ConfirmCode`	`string`	no
`RefundQueryNumber`	`long?`	yes
`RefundTransactionDate`	`DateTime?`	yes
`RefundFromParticipantCode`	`string`	no
`ResponseCode`	`string`	no
`OutgoingFastId`	`Guid?`	yes

Member names are the service's declaration names.

get-incoming-fast-list › query Parameters

object

orderBy

string

orderSort

string

pageIndex

integer · int32

pageSize

integer · int32

get-incoming-fast-list › Responses

object[]

Array of catalog-declared response records.

accountingEntryId

string · uuid

amount

number · decimal

authorizedAccountId

string · uuid

authorizedAddress

string

authorizedBirthDate

string · date

authorizedBirthPlace

string

authorizedCountryDistrict

string

authorizedCustomerId

string · uuid

authorizedIdentityNumber

string

authorizedOwner

string

cancelAccountingEntryId

string · uuid

confirmeCode

string

description

string

externalSystemCode

string

fromAccountId

string · uuid

fromAddress

string

fromBirthDate

string · date

fromBirthPlace

string

fromCustomerId

string · uuid

fromIban

string

fromIdentityNumber

fromOwner

string

fromParticipantCode

string

fromPassportNumber

string

id

string · uuid

messageType

string

Permitted values — validated against the message_type parameter. The service rejects any other value.

Value	Token	Labels
`1`	`A01-Instant Payment`	no label seeded
`2`	`M01-Customer Payment`	no label seeded
`3`	`A09-Payment Refund`	no label seeded
`4`	`H31-Refund Request`	no label seeded
`5`	`Payment Between Participants`	no label seeded
`6`	`Payment from Participant to TCMB`	no label seeded
`7`	`General Purpose Information`	no label seeded
`8`	`Balance Transfer Request`	no label seeded

paymentPurpose

integer · int32

Permitted values — validated against the payment_purpose parameter. The service rejects any other value.

Value	Token	Labels
`1`	`Residential Rent Payment`	en: Residential Rent Payment · tr: Konut Kirası Ödemesi · ar: دفع إيجار السكن
`2`	`Workplace Rent Payment`	en: Workplace Rent Payment · tr: İş Yeri Kirası Ödemesi · ar: دفع إيجار مكان العمل
`3`	`Other Rent Payment`	en: Other Rent Payment · tr: Diğer Kira Ödemesi · ar: دفعة إيجار أخرى
`4`	`E-Commerce Payment`	en: E-Commerce Payment · tr: E-Ticaret Ödemesi · ar: الدفع عبر التجارة الإلكترونية
`5`	`Salary Payment`	en: Salary Payment · tr: Maaş Ödemesi · ar: دفع الراتب
`6`	`Corporate Payment`	en: Individual Payment · tr: Bireysel Ödeme · ar: الدفع الفردي
`7`	`Individual Payment`	en: Investment · tr: Yatırım · ar: استثمار
`8`	`Investment`	en: Financial · tr: Finansal · ar: مالي
`9`	`Financial`	en: Education Payment · tr: Eğitim Ödemesi · ar: دفع التعليم
`10`	`Education Payment`	en: Membership Fee Payment · tr: Aidat Ödemesi · ar: دفع رسوم العضوية
`11`	`Membership Fee Payment`	en: Other · tr: Diğer · ar: آخر
`99`	`Others`	no label seeded

paymentSource

string

queryNumber

string

referenceInfo

string

refundCode

integer · int32

Permitted values — validated against the transfer_refund_code parameter. The service rejects any other value.

Value	Token	Labels
`1`	`Alıcı bilgileri eksik veya hatalı`	no label seeded
`2`	`Hesap numarası ile alıcı ismi uyumsuz`	no label seeded
`3`	`Hesap kapatılmış`	no label seeded
`4`	`Hesap numarası yanlış (örneğin, IBAN hesap numarasında hata var`	no label seeded
`5`	`Hesap EFT aktarımına uygun değil (örneğin, döviz hesabı)`	no label seeded
`6`	`İade İsteği mesajına istinaden iade`	no label seeded
`7`	`Mesajla gelen alıcı TCKN/VKN bilgisi katılımcıda ki kayıttan farklı`	no label seeded
`8`	`Gönderici bilgileri eksik ya da hatalı`	no label seeded
`9`	`IBAN’sız ödemelerde alıcı şube kodu hatalı`	no label seeded
`10`	`Hesap yalnızca iade mesajıyla yapılan ödemelere açık`	no label seeded
`11`	`Alıcı bilgileri ve hesap numarası bankamızda mevcut değil`	no label seeded
`99`	`Diğer nedenler`	no label seeded

statusCode

integer · int32

toAccountId

string · uuid

toIban

string

toIdentityNumber

toOwner

string

transactionDate

string · date

transactionReference

string

transactionType

integer · int32

Permitted values — validated against the transaction_type parameter. The service rejects any other value.

Value	Token	Labels
`1`	`QR`	no label seeded
`2`	`FAST`	no label seeded
`3`	`KOLAS`	no label seeded
`4`	`GOS`	no label seeded

GET/incoming-fasts

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts

Example Responses

[
  {
    "accountingEntryId": "00000000-0000-0000-0000-000000000000",
    "amount": 0,
    "authorizedAccountId": "00000000-0000-0000-0000-000000000000",
    "authorizedAddress": "authorizedAddress",
    "authorizedBirthDate": "2024-08-25",
    "authorizedBirthPlace": "authorizedBirthPlace",
    "authorizedCountryDistrict": "authorizedCountryDistrict",
    "authorizedCustomerId": "00000000-0000-0000-0000-000000000000",
    "authorizedIdentityNumber": "authorizedIdentityNumber",
    "authorizedOwner": "authorizedOwner",
    "cancelAccountingEntryId": "00000000-0000-0000-0000-000000000000",
    "confirmeCode": "confirmeCode",
    "description": "description",
    "externalSystemCode": "externalSystemCode",
    "fromAccountId": "00000000-0000-0000-0000-000000000000",
    "fromAddress": "fromAddress",
    "fromBirthDate": "2024-08-25",
    "fromBirthPlace": "fromBirthPlace",
    "fromCustomerId": "00000000-0000-0000-0000-000000000000",
    "fromIban": "fromIban",
    "fromIdentityNumber": {},
    "fromOwner": "fromOwner",
    "fromParticipantCode": "fromParticipantCode",
    "fromPassportNumber": "fromPassportNumber",
    "id": "00000000-0000-0000-0000-000000000000",
    "messageType": "messageType",
    "paymentPurpose": 0,
    "paymentSource": "paymentSource",
    "queryNumber": "queryNumber",
    "referenceInfo": "referenceInfo",
    "refundCode": 0,
    "statusCode": 0,
    "toAccountId": "00000000-0000-0000-0000-000000000000",
    "toIban": "toIban",
    "toIdentityNumber": {},
    "toOwner": "toOwner",
    "transactionDate": "2024-08-25",
    "transactionReference": "transactionReference",
    "transactionType": 0
  }
]

json

application/json

create-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

Field	Name on the wire	Declared type	Nullable
`Id`	`id`	`Guid`	no

Member names are the service's declaration names.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_12`	400	`TO_ACCOUNT_NOT_FOUND`	To Account Not Found
`ERR_MNYTRNS_14`	400	`TO_ACCOUNT_MUST_NOT_BE_PASSIVE`	To Account Must Not Be Passive
`ERR_MNYTRNS_66`	400	`ACOOUNT_HAS_CONSTRAINT`	Your money transfer transaction for the specified amount could not be completed because your daily EFT limit has been reached.

create-incoming-fast › Responses

No data returned

complete-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/complete

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found
`ERR_MNYTRNS_24`	400	`INCOMING_FAST_NOT_ACTIVE`	Incoming Fast Not Active
`ERR_MNYTRNS_25`	400	`INCOMING_FAST_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Query Number Not Found
`ERR_MNYTRNS_30`	400	`INCOMING_FAST_RESULT_NOT_FOUND`	Incoming Fast Result Not Found
`ERR_MNYTRNS_33`	400	`INCOMING_FAST_RELATED_INFO_NOT_FOUND`	Incoming Fast Related Info Not Found
`ERR_MNYTRNS_34`	400	`INCOMING_FAST_RELATED_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Related Query Number Not Found

complete-incoming-fast › Request Body

fromParticipantCode

string · required

queryNumber

integer · int32 · required

object · required

result

integer · int32 · required

resultCode

integer · int32 · required

toParticipantCode

string · required

transactionDate

string · date · required

accountingEntryId

string · uuid

complete-incoming-fast › Responses

No data returned

POST/incoming-fasts/complete

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts/complete \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}'

Example Request Body

{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}

json

The field names and types this operation declares. Replace the values before sending.

application/json

Example Responses

No example specified for this content type

complete-refund-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/complete-refund

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_23`	400	`INCOMING_FAST_REFUND_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Refund Query Number Not Found
`ERR_MNYTRNS_46`	400	`INCOMING_FAST_REFUND_RELATED_INFO_NOT_FOUND`	Incoming fast refund related information not found.
`ERR_MNYTRNS_47`	400	`INCOMING_FAST_REFUND_RELATED_QUERY_NUMBER_NOT_FOUND`	Incoming fast refund related query number not found.
`ERR_MNYTRNS_49`	400	`INCOMING_FAST_REFUND_NOT_FOUND`	Incoming fast refund not found.
`ERR_MNYTRNS_51`	400	`INCOMING_FAST_REFUND_RESULT_NOT_FOUND`	Incoming fast refund result not found.
`ERR_MNYTRNS_52`	400	`INCOMING_FAST_REFUND_NOT_ACTIVE`	Incoming fast refund not active.

complete-refund-incoming-fast › Request Body

fromParticipantCode

string · required

queryNumber

integer · int32 · required

object · required

result

integer · int32 · required

resultCode

integer · int32 · required

toParticipantCode

string · required

transactionDate

string · date · required

accountingEntryId

string · uuid

complete-refund-incoming-fast › Responses

No data returned

POST/incoming-fasts/complete-refund

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts/complete-refund \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}'

Example Request Body

{
  "accountingEntryId": "",
  "fromParticipantCode": "",
  "queryNumber": 0,
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "result": 0,
  "resultCode": 0,
  "toParticipantCode": "",
  "transactionDate": ""
}

json

The field names and types this operation declares. Replace the values before sending.

application/json

Example Responses

No example specified for this content type

refund-incoming-fast

POST

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/refund

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route declares its response as RefundFastResponseDto.

Field	Declared type	Nullable
`ConfirmCode`	`int`	no
`ConfirmCodeDetail`	`int`	no

Member names are the service's declaration names.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_23`	400	`INCOMING_FAST_REFUND_QUERY_NUMBER_NOT_FOUND`	Incoming Fast Refund Query Number Not Found
`ERR_MNYTRNS_46`	400	`INCOMING_FAST_REFUND_RELATED_INFO_NOT_FOUND`	Incoming fast refund related information not found.
`ERR_MNYTRNS_47`	400	`INCOMING_FAST_REFUND_RELATED_QUERY_NUMBER_NOT_FOUND`	Incoming fast refund related query number not found.
`ERR_MNYTRNS_48`	400	`INCOMING_FAST_REFUND_REFUND_CODE_NOT_FOUND`	Incoming fast refund refund code not found.

refund-incoming-fast › Request Body

amount

number · decimal · required

object · required

description

string · required

object · required

fromParticipantCode

string · required

queryNumber

integer · int32 · required

refundCode

string · required

Permitted values — validated against the transfer_refund_code parameter. The service rejects any other value.

Value	Token	Labels
`1`	`Alıcı bilgileri eksik veya hatalı`	no label seeded
`2`	`Hesap numarası ile alıcı ismi uyumsuz`	no label seeded
`3`	`Hesap kapatılmış`	no label seeded
`4`	`Hesap numarası yanlış (örneğin, IBAN hesap numarasında hata var`	no label seeded
`5`	`Hesap EFT aktarımına uygun değil (örneğin, döviz hesabı)`	no label seeded
`6`	`İade İsteği mesajına istinaden iade`	no label seeded
`7`	`Mesajla gelen alıcı TCKN/VKN bilgisi katılımcıda ki kayıttan farklı`	no label seeded
`8`	`Gönderici bilgileri eksik ya da hatalı`	no label seeded
`9`	`IBAN’sız ödemelerde alıcı şube kodu hatalı`	no label seeded
`10`	`Hesap yalnızca iade mesajıyla yapılan ödemelere açık`	no label seeded
`11`	`Alıcı bilgileri ve hesap numarası bankamızda mevcut değil`	no label seeded
`99`	`Diğer nedenler`	no label seeded

object · required

transactionDate

string · date · required

transactionReference

string · required

refund-incoming-fast › Responses

Success. An exact, uniquely bound route registration classifies this response as a single-record.

No data returned

POST/incoming-fasts/refund

curl https://dg-sandbox.dgpays.com/money-transfer-service/incoming-fasts/refund \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 0,
  "authorized": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "countryDistrict": "",
    "customerId": "",
    "identityNumber": "",
    "owner": ""
  },
  "description": "",
  "from": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "customerId": "",
    "iban": "",
    "identityNumber": "",
    "owner": "",
    "passportNumber": ""
  },
  "fromParticipantCode": "",
  "queryNumber": 0,
  "refundCode": "",
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "to": {
    "accountId": "",
    "iban": "",
    "identityNumber": "",
    "owner": ""
  },
  "transactionDate": "",
  "transactionReference": ""
}'

Example Request Body

{
  "amount": 0,
  "authorized": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "countryDistrict": "",
    "customerId": "",
    "identityNumber": "",
    "owner": ""
  },
  "description": "",
  "from": {
    "accountId": "",
    "address": "",
    "birthDate": "",
    "birthPlace": "",
    "customerId": "",
    "iban": "",
    "identityNumber": "",
    "owner": "",
    "passportNumber": ""
  },
  "fromParticipantCode": "",
  "queryNumber": 0,
  "refundCode": "",
  "related": {
    "fromParticipantCode": "",
    "queryNumber": 0,
    "transactionDate": ""
  },
  "to": {
    "accountId": "",
    "iban": "",
    "identityNumber": "",
    "owner": ""
  },
  "transactionDate": "",
  "transactionReference": ""
}

json

The field names and types this operation declares. Replace the values before sending.

application/json

Example Responses

No example specified for this content type

get-incoming-fast-by-id

GET

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/{id}

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Response body, read from the service source

The route declares its response as IncomingFastDto.

Field	Declared type	Nullable
`Id`	`Guid`	no
`FromCustomerId`	`Guid?`	yes
`PaymentPurpose`	`int?`	yes
`TransactionType`	`int?`	yes
`MessageType`	`int?`	yes
`ExternalSystemCode`	`string`	no
`QueryNumber`	`long?`	yes
`Amount`	`decimal?`	yes
`AuthorizedOwner`	`string`	no
`AuthorizedAccountId`	`Guid?`	yes
`AuthorizedIdentityNumber`	`string`	no
`AuthorizedAddress`	`string`	no
`AuthorizedCountryDistrict`	`string`	no
`AuthorizedBirthPlace`	`string`	no
`AuthorizedBirthDate`	`DateOnly?`	yes
`AuthorizedCustomerId`	`Guid?`	yes
`PaymentSource`	`string`	no
`FromParticipantCode`	`string`	no
`FromOwner`	`string`	no
`FromAccountId`	`Guid?`	yes
`FromIban`	`string`	no
`FromIdentityNumber`	`string`	no
`FromAddress`	`string`	no
`FromPassportNumber`	`string`	no
`FromBirthPlace`	`string`	no
`FromBirthDate`	`DateOnly?`	yes
`ToOwner`	`string`	no
`ToAccountId`	`Guid?`	yes
`ToIban`	`string`	no
`ToIdentityNumber`	`string`	no
`ReferenceInfo`	`string`	no
`Description`	`string`	no
`TransactionReference`	`string`	no
`StatusCode`	`string`	no
`AccountingEntryId`	`Guid?`	yes
`CancelAccountingEntryId`	`Guid?`	yes
`TransactionDate`	`DateTime?`	yes
`RefundCode`	`string`	no
`ConfirmCode`	`string`	no
`RefundQueryNumber`	`long?`	yes
`RefundTransactionDate`	`DateTime?`	yes
`RefundFromParticipantCode`	`string`	no
`ResponseCode`	`string`	no
`OutgoingFastId`	`Guid?`	yes

Member names are the service's declaration names.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found

get-incoming-fast-by-id › path Parameters

id

string · uuid · required

get-incoming-fast-by-id › Responses

Success. An exact, uniquely bound route registration classifies this response as a single-record.

No data returned

update-incoming-fast

PUT

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/{id}

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found

update-incoming-fast › path Parameters

id

string · required

Present in the route template but not declared as a Route-bound field in the catalog.

update-incoming-fast › Responses

No data returned

delete-incoming-fast

DELETE

https://dg-sandbox.dgpays.com/money-transfer-service

/incoming-fasts/{id}

Add Authorization: Bearer <token> yourself — generated samples and Try it do not attach a credential.

Error codes this operation is known to raise

Code	Status	Meaning	Message
`ERR_MNYTRNS_19`	400	`INCOMING_FAST_NOT_FOUND`	Incoming Fast Not Found

delete-incoming-fast › path Parameters

id

string · required

Present in the route template but not declared as a Route-bound field in the catalog.

delete-incoming-fast › Responses

No data returned

in-banks incoming-transfer